tangle-network · drewstone · Aug 17, 2026 · Aug 16, 2026 · Aug 16, 2026 · Aug 16, 2026
diff --git a/docs/api/intelligence.md b/docs/api/intelligence.md
@@ -394,6 +394,151 @@ The product owns the private state lookup and atomic write.
 
 ***
 
+### AgentProfileCandidateMeasurementExecutor
+
+Product-owned executor for exact baseline/candidate profile measurement.
+
+#### Properties
+
+##### executionRef
+
+> **executionRef**: `AgentProfileImprovementExecutionRef`
+
+#### Methods
+
+##### measure()
+
+> **measure**(`input`): `Promise`\<`AgentProfileImprovementRunReceipt`\>
+
+###### Parameters
+
+###### input
+
+`AgentProfileImprovementExperimentExecutionInput` & `object`
+
+###### Returns
+
+`Promise`\<`AgentProfileImprovementRunReceipt`\>
+
+***
+
+### ProposeAuthoredAgentProfileImprovementOptions
+
+Measure a complete human-authored, imported, or compound profile candidate.
+No optimizer runs and no optimizer receipt is fabricated.
+
+#### Properties
+
+##### runId
+
+> **runId**: `string`
+
+##### source
+
+> **source**: `object`
+
+##### profile
+
+> **profile**: `AgentProfile`
+
+##### stateDigest
+
+> **stateDigest**: [`AgentImprovementProfileStateDigest`](#agentimprovementprofilestatedigest)
+
+##### candidateProfile
+
+> **candidateProfile**: `AgentProfile`
+
+##### candidateLineage
+
+> **candidateLineage**: [`AuthoredAgentProfileCandidateLineage`](#authoredagentprofilecandidatelineage)
+
+##### diff?
+
+> `optional` **diff?**: [`AgentImprovementTargetProfileDiffOptions`](#agentimprovementtargetprofilediffoptions)
+
+Optional source/artifact metadata used on Runtime-derived profile diff steps.
+
+##### findings?
+
+> `optional` **findings?**: readonly `ProposalFinding`[]
+
+##### benchmark
+
+> **benchmark**: [`AgentProfileImprovementBenchmark`](#agentprofileimprovementbenchmark)
+
+##### executor
+
+> **executor**: [`AgentProfileCandidateMeasurementExecutor`](#agentprofilecandidatemeasurementexecutor)
+
+##### budgetUsd
+
+> **budgetUsd**: `number`
+
+One customer-approved maximum for the held-out paired measurement.
+
+##### developmentScenarios?
+
+> `optional` **developmentScenarios?**: readonly `CampaignScenarioIdentity`[]
+
+Optional identities used to prove authored/imported development work is held out.
+
+##### maxConcurrency?
+
+> `optional` **maxConcurrency?**: `number`
+
+##### signal?
+
+> `optional` **signal?**: `AbortSignal`
+
+##### candidate?
+
+> `optional` **candidate?**: `object`
+
+##### metadata?
+
+> `optional` **metadata?**: `object`
+
+###### Index Signature
+
+\[`key`: `string`\]: `AgentCandidateJsonValue`
+
+##### now?
+
+> `optional` **now?**: () => `Date`
+
+###### Returns
+
+`Date`
+
+***
+
+### ProposeAuthoredAgentProfileImprovementResult
+
+#### Properties
+
+##### candidateProfile
+
+> **candidateProfile**: `AgentProfile`
+
+##### candidateLineage
+
+> **candidateLineage**: `AgentCandidateLineage`
+
+##### experiment
+
+> **experiment**: `AgentProfileImprovementExperiment`
+
+##### measurements
+
+> **measurements**: `AgentProfileImprovementMeasurement`[]
+
+##### proposal
+
+> **proposal**: `AgentImprovementProposal`
+
+***
+
 ### CredentialRef
 
 A named secret a binding requires — declared, never carried.
@@ -1507,7 +1652,7 @@ Runtime's expired-attempt path reuses this port only to stop and dispose.
 
 ###### Inherited from
 
-[`ExactProcessCandidateExperimentExecutor`](#exactprocesscandidateexperimentexecutor).[`executor`](#executor)
+[`ExactProcessCandidateExperimentExecutor`](#exactprocesscandidateexperimentexecutor).[`executor`](#executor-1)
 
 ##### recoveryPorts
 
@@ -3503,7 +3648,7 @@ Full canonical profile used for this agent. Exported redacted with a stable hash
 
 ###### Inherited from
 
-[`IntelligenceConfig`](#intelligenceconfig).[`profile`](#profile-4)
+[`IntelligenceConfig`](#intelligenceconfig).[`profile`](#profile-5)
 
 ##### commitSha?
 
@@ -3669,6 +3814,34 @@ Return undefined only when no target write can have committed.
 
 ***
 
+### AuthoredAgentProfileCandidateLineage
+
+> **AuthoredAgentProfileCandidateLineage** = `Omit`\<`AgentCandidateLineage`, `"source"` \| `"profileDiffIds"`\> & `object`
+
+Lineage accepted by the direct candidate path. Optimizer lineage belongs to `improve()`.
+
+#### Type Declaration
+
+##### source
+
+> **source**: `Exclude`\<`AgentCandidateLineage`\[`"source"`\], `"optimizer"`\>
+
+##### profileDiffIds?
+
+> `optional` **profileDiffIds?**: `never`
+
+Runtime derives these from the exact profile change it seals.
+
+***
+
+### AuthoredAgentProfileDiffOptions
+
+> **AuthoredAgentProfileDiffOptions** = `NonNullable`\<`Parameters`\<*typeof* [`agentImprovementProfileDiffs`](#agentimprovementprofilediffs)\>\[`2`\]\>
+
+Provenance attached while Runtime derives the exact profile diff.
+
+***
+
 ### JsonSchema
 
 > **JsonSchema** = `Record`\<`string`, `unknown`\>
@@ -4197,6 +4370,25 @@ Validate and execute one product-owned activation transition.
 
 ***
 
+### proposeAuthoredAgentProfileImprovement()
+
+> **proposeAuthoredAgentProfileImprovement**(`options`): `Promise`\<[`ProposeAuthoredAgentProfileImprovementResult`](#proposeauthoredagentprofileimprovementresult)\>
+
+Put a complete authored/imported profile through the canonical profile
+experiment and proposal path without invoking `improve()`.
+
+#### Parameters
+
+##### options
+
+[`ProposeAuthoredAgentProfileImprovementOptions`](#proposeauthoredagentprofileimprovementoptions)
+
+#### Returns
+
+`Promise`\<[`ProposeAuthoredAgentProfileImprovementResult`](#proposeauthoredagentprofileimprovementresult)\>
+
+***
+
 ### manifestFromProfile()
 
 > **manifestFromProfile**(`profile`): [`CapabilityManifest`](#capabilitymanifest)

diff --git a/docs/api/primitive-catalog.md b/docs/api/primitive-catalog.md
@@ -7,7 +7,7 @@
 
 # Primitive catalog — the never-stale anti-reinvention inventory
 
-> **GENERATED** from `@tangle-network/agent-runtime@0.138.1` and `@tangle-network/agent-eval@0.146.0` by `scripts/gen-primitive-catalog.mjs`. Do NOT hand-edit — run `pnpm run docs:api`. This is the mechanical companion to the JUDGMENT in `canonical-api.md` (§2 decision table + §1.5 AgentProfile law): that doc says WHICH primitive to reach for and what NOT to build; this catalog proves WHAT exists. Per-symbol signatures + `file:line` live in the per-module pages under `docs/api/`.
+> **GENERATED** from `@tangle-network/agent-runtime@0.139.0` and `@tangle-network/agent-eval@0.146.0` by `scripts/gen-primitive-catalog.mjs`. Do NOT hand-edit — run `pnpm run docs:api`. This is the mechanical companion to the JUDGMENT in `canonical-api.md` (§2 decision table + §1.5 AgentProfile law): that doc says WHICH primitive to reach for and what NOT to build; this catalog proves WHAT exists. Per-symbol signatures + `file:line` live in the per-module pages under `docs/api/`.
 
 ## 1. agent-runtime — own public surface
 
@@ -401,7 +401,7 @@ Import from `@tangle-network/agent-runtime/tool-loop` — 12 exports.
 
 ### Intelligence SDK — Observe + provable-OFF billing
 
-Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
+Import from `@tangle-network/agent-runtime/intelligence` — 172 exports.
 
 | Symbol | Kind | Summary |
 |---|---|---|
@@ -436,6 +436,7 @@ Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
 | `prepareAgentImprovementProfileActivation` | function | Compare product-owned profiles with an exact measured transition and prepare |
 | `proposeAgentImprovement` | function | Analyze, search, then remeasure the resulting exact candidate before proposing it. |
 | `proposeAgentProfileImprovement` | function | Analyze a product-owned profile, search one profile surface, then run the |
+| `proposeAuthoredAgentProfileImprovement` | function | Put a complete authored/imported profile through the canonical profile |
 | `pullCertified` | function | Pull the certified composed profile for a target. Fail-closed: a network |
 | `resolveEffort` | function | Compile a named tier (plus optional per-field overrides) into the flat |
 | `resolveIntelligenceBaseUrl` | function | Resolve the ONE Intelligence base URL — the single knob both the send and |
@@ -459,6 +460,7 @@ Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
 | `AgentImprovementActivationResult` | interface | Immutable outcome of one idempotent, transaction-wide activation attempt. |
 | `AgentImprovementMeasuredComparison` | interface | Portable paired held-out comparison produced by a sealed candidate executor. |
 | `AgentImprovementReview` | interface | Human or tenant-policy decision bound to one exact proposal. |
+| `AgentProfileCandidateMeasurementExecutor` | interface | Product-owned executor for exact baseline/candidate profile measurement. |
 | `AgentProfileImprovementBenchmark` | interface | Product-owned task material that Runtime freezes before either profile state runs. |
 | `AgentProfileImprovementExecutor` | interface | One product execution adapter shared by optimizer search and exact profile |
 | `AppliedIntelligence` | interface | What the hook hands the agent each run. Additive over the prompt-only |
@@ -486,6 +488,7 @@ Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
 | `ModeReadiness` | interface | One mode's readiness verdict. |
 | `ProfileImprovementActivationTransitionInput` | interface | A measured profile change without raw profile bytes. |
 | `ProposeAgentProfileImprovementOptions` | interface | Complete profile-improvement path for a product-owned source. |
+| `ProposeAuthoredAgentProfileImprovementOptions` | interface | Measure a complete human-authored, imported, or compound profile candidate. |
 | `ProposedProfileDiff` | interface | A gate-certified profile diff the plane has already promoted, plus the |
 | `ProtectedExactProcessCandidateExperimentExecutor` | interface | Exact-process executor plus the ports required for durable recovery. |
 | `ProvisionedHost` | interface | A live, provisioned host the resolver tore up for a `process-on-infra` arm. |
@@ -512,6 +515,8 @@ Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
 | `AgentImprovementProfileStateResolver` | type | Product-owned retained-state lookup used only for an explicit restore. |
 | `AgentImprovementProposalSubmissionState` | type | What Runtime knows about a failed proposal submission. |
 | `AgentProfileImprovementMethodOptions` | type | The portable profile changes that the measured-profile contract permits. |
+| `AuthoredAgentProfileCandidateLineage` | type | Lineage accepted by the direct candidate path. Optimizer lineage belongs to `improve()`. |
+| `AuthoredAgentProfileDiffOptions` | type | Provenance attached while Runtime derives the exact profile diff. |
 | `CapabilityAuth` | type | How a binding authenticates at resolve time. Declared as a REQUIREMENT in the |
 | `CapabilityInterface` | type | What the agent consumes. CLOSED — a new runtime kind NEVER extends this. Each |
 | `CapabilitySurface` | type | Every interface surface tag — the closed set the resolver fans into slots. |
@@ -529,7 +534,7 @@ Import from `@tangle-network/agent-runtime/intelligence` — 166 exports.
 | `SubmitAgentImprovementProposalOutcome` | type | Typed result for proposal submission. A successful result contains the |
 | `UsageClass` | type | Usage class for billing. Base-stream tokens bill `'inference'`; every |
 
-**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentCandidateExperimentCellPlacement`, `AgentImprovementActivationResultStore`, `AgentImprovementActivationTargetPlan`, `AgentImprovementProfileReplacement`, `AgentImprovementProfileStateDigestInput`, `AgentImprovementProfileStateResolverInput`, `AgentImprovementProposal`, `AgentImprovementTargetProfileDiffOptions`, `AgentProfileImprovementActivationTargetPlan`, `CreateAgentImprovementActivationOptions`, `CreateAgentImprovementActivationResultOptions`, `CreateAgentImprovementProposalOptions`, `CreateExactProcessCandidateExperimentExecutorOptions`, `ExactProcessCandidateExperimentExecution`, `ExactProcessCandidateExperimentExecutor`, `ExecuteAgentCandidateExperimentCellOptions`, `ExecuteAgentImprovementActivationInput`, `ExecuteAgentImprovementActivationOptions`, `OptimizationActivationReceipt`, `OptimizationReceiptCost`, `ProposeAgentImprovementOptions`, `ProposeAgentImprovementResult`, `ProposeAgentProfileImprovementResult`, `PullCertifiedOptions`, `ReviewAgentImprovementInput`, `RunAgentCandidateExperimentOptions`, `RunAgentCandidateExperimentResult`, `SealedCandidateActivationTransitionInput`, `VerifyCandidateExecutionEvidenceOptions`, `AgentImprovementActivationIntent`, `AgentImprovementActivationOutcome`, `AgentImprovementActivationTargetIdentity`, `AgentImprovementActivationTransitionInput`, `AgentImprovementAnalysisOptions`, `AgentImprovementProfileActivationInput`, `AgentImprovementProfileActivationPreparation`, `AgentImprovementProfileActivationTarget`, `AgentImprovementProfileSurface`, `AgentImprovementProfileTargetState`, `AgentImprovementProfileTargetTransition`, `AgentImprovementReviewDecision`, `AgentProfileImprovementActivationOperation`, `AgentProfileMeasuredSurface`.
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentCandidateExperimentCellPlacement`, `AgentImprovementActivationResultStore`, `AgentImprovementActivationTargetPlan`, `AgentImprovementProfileReplacement`, `AgentImprovementProfileStateDigestInput`, `AgentImprovementProfileStateResolverInput`, `AgentImprovementProposal`, `AgentImprovementTargetProfileDiffOptions`, `AgentProfileImprovementActivationTargetPlan`, `CreateAgentImprovementActivationOptions`, `CreateAgentImprovementActivationResultOptions`, `CreateAgentImprovementProposalOptions`, `CreateExactProcessCandidateExperimentExecutorOptions`, `ExactProcessCandidateExperimentExecution`, `ExactProcessCandidateExperimentExecutor`, `ExecuteAgentCandidateExperimentCellOptions`, `ExecuteAgentImprovementActivationInput`, `ExecuteAgentImprovementActivationOptions`, `OptimizationActivationReceipt`, `OptimizationReceiptCost`, `ProposeAgentImprovementOptions`, `ProposeAgentImprovementResult`, `ProposeAgentProfileImprovementResult`, `ProposeAuthoredAgentProfileImprovementResult`, `PullCertifiedOptions`, `ReviewAgentImprovementInput`, `RunAgentCandidateExperimentOptions`, `RunAgentCandidateExperimentResult`, `SealedCandidateActivationTransitionInput`, `VerifyCandidateExecutionEvidenceOptions`, `AgentImprovementActivationIntent`, `AgentImprovementActivationOutcome`, `AgentImprovementActivationTargetIdentity`, `AgentImprovementActivationTransitionInput`, `AgentImprovementAnalysisOptions`, `AgentImprovementProfileActivationInput`, `AgentImprovementProfileActivationPreparation`, `AgentImprovementProfileActivationTarget`, `AgentImprovementProfileSurface`, `AgentImprovementProfileTargetState`, `AgentImprovementProfileTargetTransition`, `AgentImprovementReviewDecision`, `AgentProfileImprovementActivationOperation`, `AgentProfileMeasuredSurface`.
 
 ### Execution kernel — recursive atom, supervision, executors, round-synchronous loop
 

diff --git a/docs/canonical-api.md b/docs/canonical-api.md
@@ -4,7 +4,7 @@
 Generated signatures and the complete export list live in docs/api/.
 Run pnpm docs:freshness after editing this file. -->
 
-> **Version 0.138.1.**
+> **Version 0.139.0.**
 > [`docs/api/primitive-catalog.md`](./api/primitive-catalog.md) lists every export and import path.
 > `agent-eval` must satisfy `>=0.146.0 <0.147.0`.
 > `sandbox` must satisfy `>=0.27.1 <0.28.0`.

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.138.1",
+  "version": "0.139.0",
   "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.",
   "homepage": "https://github.com/tangle-network/agent-runtime#readme",
   "repository": {