Repository navigation
Releases
0.12.1
Repository moved to temporal-community/temporal-agent-kit; package metadata now points there.
0.12.0
Release notes
Temporal Agent Harness is now Temporal Agent Kit. This release and every later one is temporal-agent-kit on PyPI; temporal-agent-harness 0.11.0 is the last release under the old name. Nothing about how agents run changes: no Temporal workflow, signal, update, query, activity or task-queue name changed, so running workflows keep working across the upgrade.
Upgrading from temporal-agent-harness
- Swap the dependency:
uv remove temporal-agent-harness && uv add 'temporal-agent-kit[<your extras>]'(extras keep their names). - Update imports and names:
| Before | After |
|---|---|
temporal_agent_harness.harness (from temporal_agent_harness.harness import agent) |
temporal_agent_kit (from temporal_agent_kit import agent) |
temporal_agent_harness.harness.<module> (state, agent_protocol, code_mode, agent_client, …) |
temporal_agent_kit.<module> |
temporal_agent_harness.<module> (plugin, utils, web, ai_sdks, …) |
temporal_agent_kit.<module> |
ai_sdks.openai_agents_harness |
ai_sdks.openai_agents (one module for the plugin and the glue) |
ai_sdks.strands_agents_harness |
ai_sdks.strands_agents (one module for the plugin and the glue) |
ai_sdks.pydantic_ai_harness / ai_sdks.typesafe_harness |
ai_sdks.pydantic_ai / ai_sdks.typesafe |
AgentHarnessPlugin |
AgentKitPlugin |
HarnessState / HarnessStateError |
AgentState / AgentStateError |
create_agent_harness_app |
create_agent_kit_app |
harness_observer_factory, as_harness_mcp_server(s), is_harness_mcp_server |
kit_observer_factory, as_kit_mcp_server(s), is_kit_mcp_server |
harness_strands_agent, harness_stream_route |
kit_strands_agent, kit_stream_route |
HarnessDeps (.harness_stream_context), HarnessStreamingModel, TemporalAgentHarnessDurability, harness_model, build_harness_toolset, harness_event_stream_handler |
KitDeps (.kit_stream_context), KitStreamingModel, TemporalAgentKitDurability, kit_model, build_kit_toolset, kit_event_stream_handler |
HarnessTypeSafe |
KitTypeSafe |
model_config["harness_validate_on_commit"] |
model_config["kit_validate_on_commit"] |
- The CLI is
temporal-agent-kit(temporal-agent-kit serve,dev,schema,init, …). - Reinstall the agent skill with
uv run temporal-agent-kit skills install; it is nowtemporal-agent-kit-python. Delete the oldtemporal-harness-pythonskill directory (under.agents/skills/or.claude/skills/).
Also in this release
- The console no longer starts a session when it opens. With no session in the address bar it shows a home desk with each SDK's quickstart, and a link to a session that no longer exists says so instead of starting a new one.
- Code Mode's OKF graph reads
[[wikilinks]]([[target]],[[target#heading]],[[target|alias]],![[target]]) as links between concepts.
npm-v0.6.1
Release the npm packages 0.6.0 → 0.6.1, published in this order:
@temporalio/agent-kit-client@temporalio/agent-kit-codegen@temporalio/agent-kit@temporalio/agent-kit-react@temporalio/agent-kit-svelte@temporalio/agent-kit-worker
Every workspace dependency on these packages now requires ^0.6.1.
Release notes
Repository moved to temporal-community/temporal-agent-kit; package metadata now points there.
npm-v0.6.0
Release the npm packages 0.5.0 → 0.6.0, published in this order:
@temporalio/agent-kit-client@temporalio/agent-kit-codegen@temporalio/agent-kit@temporalio/agent-kit-react@temporalio/agent-kit-svelte@temporalio/agent-kit-worker
Every workspace dependency on these packages now requires ^0.6.0.
Release notes
Temporal Agent Harness is now Temporal Agent Kit. The packages are now published as @temporalio/agent-kit*; the @temporalio/agent-harness* packages stop at 0.5.0 and are deprecated. Not
hing about how agents run changes: no Temporal workflow, signal, update, query, activity or task-queue name changed, so running workflows keep working across the upgrade.
Upgrading from @temporalio/agent-harness*
- Swap the dependencies (same suffixes):
| Before | After |
|---|---|
@temporalio/agent-harness |
@temporalio/agent-kit |
@temporalio/agent-harness-worker |
@temporalio/agent-kit-worker |
@temporalio/agent-harness-client |
@temporalio/agent-kit-client |
@temporalio/agent-harness-react |
@temporalio/agent-kit-react |
@temporalio/agent-harness-svelte |
@temporalio/agent-kit-svelte |
@temporalio/agent-harness-codegen |
@temporalio/agent-kit-codegen |
- Update subpath imports and names:
| Before | After |
|---|---|
…/harness/agent-protocol, …/harness/agent-schema, …/harness/agent-workflow, …/harness/code-mode[/vfs|/okf] |
…/agent-protocol, …/agent-schema, …/agent-workflow, `…/code-mode[/v |
| fs|/okf]` | |
@temporalio/agent-harness-worker/harness/agent-client, …/harness/code-mode/monty-stepper |
@temporalio/agent-kit-worker/agent-client, …/code-mode/monty-stepper |
…/ai-sdks/openai-agents-harness |
…/ai-sdks/openai-agents |
…/ai-sdks/strands-agents-harness |
…/ai-sdks/strands-agents |
AgentHarnessPlugin, harnessActivities |
AgentKitPlugin, kitActivities |
HarnessStateError |
AgentStateError |
HarnessProvider, createHarnessContext |
KitProvider, createKitContext |
HarnessTool, AnyHarnessTool, HarnessMessage, HarnessMcpOptions |
KitTool, AnyKitTool, KitMessage, KitMcpOptions |
asHarnessMcpServer(s), isHarnessMcpServer, harnessObserverFactory |
asKitMcpServer(s), isKitMcpServer, kitObserverFactory |
harnessStrandsAgent (HarnessStrandsAgentOptions), harnessStreamRoute, HarnessStreamRoute, HarnessStreamToken |
kitStrandsAgent (KitStrandsAgentOptions), kitStreamRoute, `KitSt |
reamRoute, KitStreamToken` |
- Binaries:
agent-harness→agent-kit,agent-harness-schema→agent-kit-schema,harness-codegen→agent-kit-codegen. In a project from the starter, rename the npm scriptsharness: dev,harness:schema,harness:doctorandharness:skilltoagent-kit:*. - Reinstall the agent skill with
npm run agent-kit:skill; it is nowtemporal-agent-kit-typescript. Delete the oldtemporal-harness-typescriptskill directory (under.agents/skills/or
.claude/skills/).
Also in this release
- Code Mode's OKF graph reads
[[wikilinks]]([[target]],[[target#heading]],[[target|alias]],![[target]]) as links between concepts.
0.11.0
Release notes
- New: Strands Agents integration (
pip install "temporal-agent-harness[strands-agents]"). It's vendored fromtemporalio/ai-integrationsnow streaming model and tool events into the harness. Harness tools, MCP and sandbox calls go through the harness approval policy, and mid-turn steering works.
npm-v0.5.0
Release the npm packages 0.4.0 → 0.5.0, published in this order:
@temporalio/agent-harness-client@temporalio/agent-harness-codegen@temporalio/agent-harness@temporalio/agent-harness-react@temporalio/agent-harness-svelte@temporalio/agent-harness-worker
Every workspace dependency on these packages now requires ^0.5.0.
Release notes
- New: Strands Agents integration, at
@temporalio/agent-harness/ai-sdks/strands-agents[-harness]and@temporalio/agent-harness-worker/ai-sdks/strands-agents[-harness].@strands-agents/sdk(^1.24) is an optional peer dependency. It's vendored fromtemporalio/ai-integrationswith every upstream feature kept.harnessStrandsAgentstreams model and tool events into the turn, and it takes harness tools andTemporalMCPClienthandles, all run through the approval policy. Mid-turn steering works. - UI bindings: Strands thought summaries now render in @temporalio/agent-harness-client.
0.10.0
- New: steer an agent mid-turn with runner.steer(); the State Flow shows each handler in its own lane.
- Experimental: the Nexus agent adapter is back, updated to the current agent interface.
- Console: State Flow minimap hidden by default; pane resizing fits the window.
npm-v0.4.0
Release the npm packages 0.3.1 → 0.4.0, published in this order:
@temporalio/agent-harness-client@temporalio/agent-harness-codegen@temporalio/agent-harness@temporalio/agent-harness-react@temporalio/agent-harness-svelte@temporalio/agent-harness-worker
Every workspace dependency on these packages now requires ^0.4.0.
Release notes
- New: mid-turn steering. While an agent is working, a message handler can call runner.steer(text), and the text reaches the model in the next tool result. The OpenAI Agents adapter attaches it automatically; custom loops use runner.claimSteering({ toolId }). New events: steering_enqueued, steering_claimed and steering_dropped.
- UI bindings: sessions expose steering (queued, claimed and dropped messages). React adds a useSteering() hook; Svelte adds session.steering.
- Breaking: agent-harness skills install --for codex is now --for agents. In a terminal, run without --for or --dest, it asks where to install (Claude Code .claude/skills and/or .agents/skills); outside a terminal it fails unless you pass one. The starter's schema script is renamed harness:schema.
0.9.0
Release temporal-agent-harness 0.8.0 → 0.9.0 to PyPI.
Changed: python/pyproject.toml, python/uv.lock (uv lock), the README's install pins.
Review the lockfile diff for dependency changes beyond the version.
Release notes
Replace this section before merging: what changed, by package; breaking changes and
migrations; parity exceptions; the tested version combination. It becomes the GitHub
Release body.
Checklist
See RELEASE.md.
Prepared by Prepare release, which ran bazel test //python/tests:test_packaged_distributions before
pushing this branch. Wait for the required checks. Merging publishes: it tags the merged
commit 0.9.0, creates a GitHub Release from this description, and runs
publish.yml. Closing without merging publishes nothing.
npm-v0.3.1
Release the npm packages 0.3.0 → 0.3.1, published in this order:
@temporalio/agent-harness-client@temporalio/agent-harness-codegen@temporalio/agent-harness@temporalio/agent-harness-react@temporalio/agent-harness-svelte@temporalio/agent-harness-worker
Every workspace dependency on these packages now requires ^0.3.1.
Release notes
Replace this section before merging: what changed, by package; breaking changes and
migrations; parity exceptions; the tested version combination. It becomes the GitHub
Release body.
Checklist
See RELEASE.md.
Prepared by Prepare release, which ran bazel test //typescript/packages/... before
pushing this branch. Wait for the required checks. Merging publishes: it tags the merged
commit npm-v0.3.1, creates a GitHub Release from this description, and runs
publish-npm.yml. Closing without merging publishes nothing.