@tangle-network/agent-runtime 0.104.0 → 0.105.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/README.md +176 -42
  2. package/dist/agent.js +4 -4
  3. package/dist/candidate-execution/index.d.ts +2 -2
  4. package/dist/candidate-execution/index.js +4 -4
  5. package/dist/{chunk-2QJSNOGK.js → chunk-C5RTIBNZ.js} +2 -2
  6. package/dist/{chunk-SNSMRT6H.js → chunk-CTRA64LY.js} +3 -3
  7. package/dist/{chunk-ZXICDSAK.js → chunk-H5QPIZNX.js} +2 -2
  8. package/dist/{chunk-2X65HYMI.js → chunk-HLKC4UYB.js} +1 -13
  9. package/dist/chunk-HLKC4UYB.js.map +1 -0
  10. package/dist/{chunk-3PPVCS75.js → chunk-HNP72PNU.js} +3 -10
  11. package/dist/chunk-HNP72PNU.js.map +1 -0
  12. package/dist/chunk-OPVWXJ2H.js +75 -0
  13. package/dist/chunk-OPVWXJ2H.js.map +1 -0
  14. package/dist/{chunk-B7K7V22Y.js → chunk-RDOAVVHY.js} +2 -2
  15. package/dist/{chunk-L5DST3QC.js → chunk-SMQXZGLZ.js} +1 -1
  16. package/dist/chunk-SMQXZGLZ.js.map +1 -0
  17. package/dist/{chunk-FJI3EXU3.js → chunk-UHEZW5BU.js} +1104 -588
  18. package/dist/chunk-UHEZW5BU.js.map +1 -0
  19. package/dist/{chunk-HAO4CXHP.js → chunk-VISA6CI3.js} +3 -3
  20. package/dist/{chunk-2UABGGUB.js → chunk-WMTCUOQL.js} +5 -5
  21. package/dist/{chunk-ATDFUJYI.js → chunk-WRTOVNN4.js} +4 -4
  22. package/dist/{chunk-ATDFUJYI.js.map → chunk-WRTOVNN4.js.map} +1 -1
  23. package/dist/{chunk-SBTWKPVR.js → chunk-WSTRQZYQ.js} +1 -1
  24. package/dist/chunk-WSTRQZYQ.js.map +1 -0
  25. package/dist/{chunk-5HNDYWUT.js → chunk-XBG2W2VW.js} +13 -3
  26. package/dist/chunk-XBG2W2VW.js.map +1 -0
  27. package/dist/{chunk-STJEHM5F.js → chunk-YJZA2BIK.js} +2 -2
  28. package/dist/{chunk-STJEHM5F.js.map → chunk-YJZA2BIK.js.map} +1 -1
  29. package/dist/{completion-gate-Bv47cOnn.d.ts → completion-gate-BMy5LGoP.d.ts} +1 -1
  30. package/dist/{coordination-CxtzMxSM.d.ts → coordination-BZZSVYpZ.d.ts} +2 -2
  31. package/dist/index.d.ts +101 -177
  32. package/dist/index.js +373 -235
  33. package/dist/index.js.map +1 -1
  34. package/dist/intelligence.d.ts +49 -40
  35. package/dist/intelligence.js +14 -57
  36. package/dist/intelligence.js.map +1 -1
  37. package/dist/knowledge.d.ts +4 -4
  38. package/dist/knowledge.js +8 -8
  39. package/dist/{local-harness-CtK9dSny.d.ts → local-harness-BDNcl6jI.d.ts} +1 -1
  40. package/dist/{loop-runner-bin-DUOGtvOl.d.ts → loop-runner-bin-68aoM9-7.d.ts} +3 -11
  41. package/dist/loop-runner-bin.d.ts +4 -6
  42. package/dist/loop-runner-bin.js +5 -5
  43. package/dist/loops.d.ts +11 -11
  44. package/dist/loops.js +5 -5
  45. package/dist/mcp/bin.js +2 -2
  46. package/dist/mcp/index.d.ts +7 -8
  47. package/dist/mcp/index.js +6 -6
  48. package/dist/mcp/memory-bin.js +1 -1
  49. package/dist/primeintellect/index.d.ts +2 -3
  50. package/dist/primeintellect/index.js +5 -6
  51. package/dist/primeintellect/index.js.map +1 -1
  52. package/dist/{protected-model-port-DzkUY3HQ.d.ts → protected-model-port-B4t-OQjL.d.ts} +1 -1
  53. package/dist/{improve--2A0gK1-.d.ts → redact-BuFjxBUJ.d.ts} +201 -160
  54. package/dist/{structural-rollout-C4mabf87.d.ts → structural-rollout-DEh6CEsa.d.ts} +2 -2
  55. package/dist/{supervise-7q9F5brx.d.ts → supervise-4_48wwvy.d.ts} +2 -2
  56. package/dist/testing.js +9 -9
  57. package/dist/testing.js.map +1 -1
  58. package/dist/{worktree-fanout-WsOzt8qu.d.ts → worktree-fanout-DxhAWr5Z.d.ts} +2 -2
  59. package/package.json +6 -5
  60. package/skills/build-with-agent-runtime/SKILL.md +15 -9
  61. package/skills/loop-writer/SKILL.md +1 -1
  62. package/dist/chunk-2X65HYMI.js.map +0 -1
  63. package/dist/chunk-3PPVCS75.js.map +0 -1
  64. package/dist/chunk-5HNDYWUT.js.map +0 -1
  65. package/dist/chunk-FJI3EXU3.js.map +0 -1
  66. package/dist/chunk-L5DST3QC.js.map +0 -1
  67. package/dist/chunk-SBTWKPVR.js.map +0 -1
  68. /package/dist/{chunk-2QJSNOGK.js.map → chunk-C5RTIBNZ.js.map} +0 -0
  69. /package/dist/{chunk-SNSMRT6H.js.map → chunk-CTRA64LY.js.map} +0 -0
  70. /package/dist/{chunk-ZXICDSAK.js.map → chunk-H5QPIZNX.js.map} +0 -0
  71. /package/dist/{chunk-B7K7V22Y.js.map → chunk-RDOAVVHY.js.map} +0 -0
  72. /package/dist/{chunk-HAO4CXHP.js.map → chunk-VISA6CI3.js.map} +0 -0
  73. /package/dist/{chunk-2UABGGUB.js.map → chunk-WMTCUOQL.js.map} +0 -0
@@ -3,8 +3,8 @@ import { AnalystFinding, DefaultVerdict } from '@tangle-network/agent-eval';
3
3
  import { N as NodeId, a as Settled, g as Spend, h as AgentSpec, S as Scope, c as SpawnJournal, b as ResultBlobStore, i as ExecutorRegistry, B as Budget, A as Agent, j as RootHandle, e as SupervisedResult, f as Executor } from './types-CvNwMzQt.js';
4
4
  import { I as Iteration, R as RuntimeHooks } from './types-BCoemcXU.js';
5
5
  import { BackendType } from '@tangle-network/sandbox';
6
- import { W as WorktreeHarnessResult, G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-Bv47cOnn.js';
7
- import { L as LocalHarness, r as runLocalHarness } from './local-harness-CtK9dSny.js';
6
+ import { W as WorktreeHarnessResult, G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-BMy5LGoP.js';
7
+ import { L as LocalHarness, r as runLocalHarness } from './local-harness-BDNcl6jI.js';
8
8
 
9
9
  /**
10
10
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-runtime",
3
- "version": "0.104.0",
3
+ "version": "0.105.0",
4
4
  "description": "Shared task-lifecycle skeleton for agents: a recursive loop kernel for chat turns, one-shot tasks, and multi-attempt loops, with trace capture and eval-gated self-improvement. Domain behavior lives in adapters; scoring and ship-gates in @tangle-network/agent-eval.",
5
5
  "homepage": "https://github.com/tangle-network/agent-runtime#readme",
6
6
  "repository": {
@@ -114,7 +114,8 @@
114
114
  "verify:bench": "pnpm build && pnpm --filter @tangle-network/agent-bench run typecheck:public && pnpm --filter @tangle-network/agent-bench test && pnpm --filter @tangle-network/agent-bench run verify:package:local-runtime",
115
115
  "verify:bench:published": "pnpm build && pnpm --filter @tangle-network/agent-bench run typecheck:public && pnpm --filter @tangle-network/agent-bench test && pnpm --filter @tangle-network/agent-bench run verify:package",
116
116
  "verify:package": "pnpm run check:testing-fixture && pnpm run check:skills && node scripts/verify-package-exports.mjs",
117
- "verify:primeintellect": "pnpm build && node scripts/verify-primeintellect-v1.mjs",
117
+ "verify:official-optimizers": "node scripts/verify-official-optimizers.mjs",
118
+ "verify:primeintellect": "pnpm build && node scripts/verify-primeintellect.mjs",
118
119
  "verify:primeintellect:live": "pnpm build && node scripts/verify-primeintellect-live.mjs",
119
120
  "docs:api": "pnpm run build && typedoc && node scripts/gen-primitive-catalog.mjs",
120
121
  "docs:freshness": "node scripts/check-docs-freshness.mjs",
@@ -122,7 +123,7 @@
122
123
  },
123
124
  "devDependencies": {
124
125
  "@biomejs/biome": "^2.4.15",
125
- "@tangle-network/agent-eval": "0.125.0",
126
+ "@tangle-network/agent-eval": "0.126.6",
126
127
  "@tangle-network/agent-interface": "0.32.0",
127
128
  "@tangle-network/sandbox": "^0.12.0",
128
129
  "@types/node": "^25.9.3",
@@ -154,7 +155,7 @@
154
155
  "license": "MIT",
155
156
  "packageManager": "pnpm@10.28.0",
156
157
  "peerDependencies": {
157
- "@tangle-network/agent-eval": ">=0.122.8 <0.126.0",
158
+ "@tangle-network/agent-eval": ">=0.126.6 <0.127.0",
158
159
  "@tangle-network/agent-interface": ">=0.32.0 <0.33.0",
159
160
  "@tangle-network/sandbox": ">=0.12.0 <1.0.0",
160
161
  "playwright": "^1.40.0"
@@ -168,7 +169,7 @@
168
169
  }
169
170
  },
170
171
  "dependencies": {
171
- "@tangle-network/agent-knowledge": "^4.1.0",
172
+ "@tangle-network/agent-knowledge": "5.0.1",
172
173
  "@tangle-network/agent-profile-materialize": "0.5.1",
173
174
  "tar-stream": "3.2.0"
174
175
  }
@@ -34,7 +34,7 @@ Do not move product storage transactions into a provider-neutral package.
34
34
  |---|---|
35
35
  | One product chat turn | `handleChatTurn(...)` |
36
36
  | One normalized streamed agent turn | `streamAgentTurn(...)` and `collectAgentTurn(...)` |
37
- | One task or multi-turn loop | `runAgentTask(...)`, `runAgentTaskStream(...)`, or `runLoop(...)` |
37
+ | One task or multi-turn loop | `runAgentTask(...)`, `runAgentTaskStream(...)`, or `runAgentRounds(...)` |
38
38
  | Supervisor and workers | `supervise(...)` or `superviseSurface(...)` |
39
39
  | Parallel work with a shared budget | `fanout(...)` |
40
40
  | Fixed composition | `pipeline(...)`, `panel(...)`, or `verify(...)` |
@@ -50,11 +50,16 @@ Do not move product storage transactions into a provider-neutral package.
50
50
 
51
51
  ## Improvement flow
52
52
 
53
- `improve(profile, findings, options)` searches one surface and returns a detached winner.
53
+ `improve(profile, options)` searches one surface and returns a detached winner.
54
54
  It never changes a profile, document, repository, memory store, or knowledge base.
55
55
 
56
- Supported profile surfaces are prompt, one named inline skill, tools, MCP, hooks, subagents, whole profile, and curated memory in `profile.resources.instructions`.
57
- Code uses isolated worktrees and returns a sealed patch candidate.
56
+ For a profile field, pass one complete agent-eval `OptimizationMethod`, explicit train, selection, and final-test partitions, judges, and the candidate execution function.
57
+ Use `officialGepa(...)` with an explicit recipe when upstream GEPA should own search.
58
+ Use `officialSkillOpt(...)` when Microsoft's SkillOpt should own search.
59
+ Both require `evaluationId`; change it whenever dispatch, judges, models, or scoring behavior changes.
60
+ Resumable runs accept `never`, `if-compatible`, or `required` and reuse state only when agent-eval derives the same run identity.
61
+ Runtime has no local prompt, skill, memory, or profile optimizer fallback.
62
+ Code uses Runtime's isolated worktrees and returns a sealed patch candidate.
58
63
  Knowledge uses `runKnowledgeImprovementJob(...)` and returns paired snapshots.
59
64
 
60
65
  Use `proposeAgentImprovement(...)` for a production proposal.
@@ -80,12 +85,12 @@ Never treat a lost response as a failed write without reconciling it.
80
85
 
81
86
  ## Surface rules
82
87
 
83
- - Prompt changes `profile.prompt` only.
84
- - Skill optimization selects one inline skill by `skills.resourceName`; profile resources must fail closed.
88
+ - Prompt changes `profile.prompt` only and requires a complete method.
89
+ - Skill optimization selects one inline skill by `skills.resourceName`, requires a complete method, and requires profile resources to fail closed.
85
90
  - Curated memory changes `profile.resources.instructions`; retrieval stores and memory databases belong in the knowledge flow.
86
- - Tools, MCP, hooks, subagents, and whole-profile changes require an explicit proposer because Runtime cannot invent domain capabilities safely.
91
+ - Tools, MCP, hooks, subagents, curated memory, rollout policy, and whole-profile changes require a complete method.
87
92
  - Code candidates must come from the Runtime worktree path so patch identity and cleanup stay intact.
88
- - Workflow and policy files are code surfaces; parameter sweeps come from agent-eval.
93
+ - Workflow files are code surfaces. Parameter sweeps belong in a complete agent-eval method.
89
94
  - Knowledge candidates remain detached until the shared activation path applies or restores their frozen snapshots.
90
95
 
91
96
  ## Product integration
@@ -104,7 +109,8 @@ The product must not recreate candidate hashing, paired comparison, confidence i
104
109
  ## Do not duplicate
105
110
 
106
111
  - Do not write a provider-specific profile wrapper; extend `AgentProfile` and its materializer.
107
- - Do not write a second optimizer loop; compose Eval proposers through `improve(...)`.
112
+ - Do not write a second optimizer loop; pass a complete agent-eval method to `improve(...)`.
113
+ - Do not use Runtime's code generator to approximate GEPA, SkillOpt, or another upstream profile optimizer.
108
114
  - Do not write a second candidate catalog; persist the immutable proposal records.
109
115
  - Do not let an analyst or adapter commit, push, open a pull request, or edit a live store.
110
116
  - Do not hand-roll SSE parsing, usage totals, profile matrices, bootstrap statistics, sandbox acquisition, or worktree cleanup.
@@ -21,7 +21,7 @@ Do not copy signatures from this skill.
21
21
  | Parallel repository workers with isolated branches | `worktreeFanout(...)` |
22
22
  | Repeated work in a graded tool environment | `runAgentic(...)` |
23
23
  | Equal-budget comparison over that environment | `runBenchmark(...)` |
24
- | Low-level round policy with custom planning and stopping | `runLoop(...)` |
24
+ | Low-level round policy with custom planning and stopping | `runAgentRounds(...)` |
25
25
 
26
26
  If an existing row fits, use it and stop.
27
27
  Do not create another wrapper solely to rename inputs or results.