@tangle-network/agent-runtime 0.91.0 → 0.92.1

package/dist/intelligence.d.ts

@@ -1,8 +1,17 @@
-import { d as LoopTraceEvent } from './types-SyuwunY_.js';
-import { AgentProfileDiff, AgentProfile, AgentProfileMcpServer } from '@tangle-network/agent-interface';
-import { b as ToolSpec } from './router-client-DJImUDlm.js';
+import { AgentCandidateBundle, AgentProfile, Sha256Digest, AgentProfileDiff, AgentProfileMcpServer } from '@tangle-network/agent-interface';
+import { g as LoopTraceEvent, b as RuntimeStreamEvent } from './types-B00NtbCs.js';
+import { b as ToolSpec, c as RuntimeTelemetryOptions } from './sanitize-C9go6tXj.js';
+import { AnalystFinding } from '@tangle-network/agent-eval/analyst';
+import { Scenario, SelfImproveResult } from '@tangle-network/agent-eval/contract';
+import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
+import { A as AgentCandidateTaskExecution, a as AgentCandidateExecutionPorts, P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, b as AgentCandidateRunFinalization } from './prepare-Z08a4heC.js';
+import { I as ImproveSurface, a as ImproveOptions, b as ImproveResult } from './improve-CUVCq7xg.js';
 import '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
+import './local-harness-dcD5WTTr.js';
+import 'node:child_process';
+import './agentic-generator-B8oeE2Yv.js';
+import '@tangle-network/agent-eval/campaign';
 
 /**
  *
@@ -117,6 +126,99 @@ interface EffortOverridesCompiled {
  */
 declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
 
+type AgentCandidateBundleInput = Omit<AgentCandidateBundle, 'digest'>;
+
+type AgentImprovementEvaluation<TScenario extends Scenario, TArtifact> = Pick<SelfImproveResult<TScenario, TArtifact>, 'baseline' | 'winner' | 'lift' | 'diff' | 'provenance' | 'gateDecision' | 'generationsExplored' | 'durationMs' | 'totalCostUsd' | 'insight' | 'power'>;
+interface AgentImprovementProposal<TScenario extends Scenario = Scenario, TArtifact = unknown> {
+    schemaVersion: 1;
+    kind: 'agent-improvement-proposal';
+    runId: string;
+    surface: ImproveSurface;
+    proposedAt: string;
+    baselineProfileHash: string;
+    candidateProfile: AgentProfile;
+    candidateProfileHash: string;
+    findings: AnalystFinding[];
+    evaluation: AgentImprovementEvaluation<TScenario, TArtifact>;
+    candidateBundle?: AgentCandidateBundle;
+    digest: Sha256Digest;
+}
+type AgentImprovementReviewDecision = 'approve' | 'reject' | 'request-changes';
+interface AgentImprovementReview {
+    schemaVersion: 1;
+    kind: 'agent-improvement-review';
+    proposalDigest: Sha256Digest;
+    candidateBundleDigest?: Sha256Digest;
+    decision: AgentImprovementReviewDecision;
+    reviewedBy: string;
+    reviewedAt: string;
+    reason: string;
+    feedback?: string;
+    digest: Sha256Digest;
+}
+interface CandidateExecutionEvidence {
+    proposalDigest: Sha256Digest;
+    reviewDigest: Sha256Digest;
+    bundleDigest: Sha256Digest;
+    executionId: string;
+    executionPlanDigest: Sha256Digest;
+    materializationReceiptDigest: Sha256Digest;
+    succeeded: boolean;
+    runReceiptDigest?: Sha256Digest;
+}
+interface ProposeAgentImprovementOptions<TScenario extends Scenario, TArtifact> {
+    runId: string;
+    profile: AgentProfile;
+    analysis: Omit<RunAnalystLoopOpts, 'runId' | 'improvementAdapter' | 'autoApply'>;
+    improvement: ImproveOptions<TScenario, TArtifact>;
+    /**
+     * Optional environment adapter that freezes an executable bundle after the
+     * measured comparison recommends the candidate. Runtime validates and
+     * computes the bundle digest; adapters never implement hashing themselves.
+     */
+    buildCandidate?: (input: {
+        analysis: RunAnalystLoopResult;
+        improvement: ImproveResult<TScenario, TArtifact>;
+    }) => AgentCandidateBundleInput | Promise<AgentCandidateBundleInput>;
+    now?: () => Date;
+}
+interface ProposeAgentImprovementResult<TScenario extends Scenario, TArtifact> {
+    analysis: RunAnalystLoopResult;
+    improvement: ImproveResult<TScenario, TArtifact>;
+    proposal: AgentImprovementProposal<TScenario, TArtifact>;
+}
+interface ReviewAgentImprovementInput {
+    decision: AgentImprovementReviewDecision;
+    reviewedBy: string;
+    reason: string;
+    feedback?: string;
+    now?: () => Date;
+}
+interface ExecuteApprovedAgentCandidateOptions {
+    proposal: AgentImprovementProposal;
+    review: AgentImprovementReview;
+    /** Product-owned authentication check for the persisted approval record. */
+    authorizeReview: (review: AgentImprovementReview, proposal: AgentImprovementProposal) => boolean | Promise<boolean>;
+    task: AgentCandidateTaskExecution;
+    ports: AgentCandidateExecutionPorts;
+    preparation?: PrepareAgentCandidateExecutionOptions;
+    execution: ExecutePreparedAgentCandidateOptions;
+}
+interface ExecuteApprovedAgentCandidateResult {
+    finalization: AgentCandidateRunFinalization;
+    evidence: CandidateExecutionEvidence;
+}
+/** Analyze one run and produce one measured, review-only improvement proposal. */
+declare function proposeAgentImprovement<TScenario extends Scenario, TArtifact>(options: ProposeAgentImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentImprovementResult<TScenario, TArtifact>>;
+/** Persist an approve/reject/change-request decision bound to one exact proposal. */
+declare function reviewAgentImprovementProposal(inputProposal: AgentImprovementProposal, input: ReviewAgentImprovementInput): AgentImprovementReview;
+/** Verify, materialize, run, grade, and receipt only the exact approved bundle. */
+declare function executeApprovedAgentCandidate(options: ExecuteApprovedAgentCandidateOptions): Promise<ExecuteApprovedAgentCandidateResult>;
+/** Validate a proposal's schema, profile, sealed bundle, and canonical digest. */
+declare function verifyAgentImprovementProposal(input: unknown): AgentImprovementProposal;
+/** Validate a review's decision fields and canonical digest. */
+declare function verifyAgentImprovementReview(input: unknown): AgentImprovementReview;
+
 /**
  *
  * Redaction for Intelligence trace export. The trace carries the customer's
@@ -765,6 +867,9 @@ declare function composeCertifiedProfileFromWire(base: {
  *  `proposals`/`applyProfile` surface the promoted profile DIFFS — never
  *  auto-applied; `record` enriches the {@link RunRecord} that is sent. */
 interface AppliedIntelligence {
+    /** Stable ids shared by the run span and every nested runtime/loop span. */
+    runId: string;
+    traceId: string;
     /** The certified profile in effect (null when none promoted / pull failed —
      *  fail-closed: the agent runs on its base surface). */
     certified: CertifiedProfile | null;
@@ -807,6 +912,8 @@ interface IntelligenceHookConfig extends IntelligenceConfig {
 type IntelligenceWrapped<I, O> = ((input: I) => Promise<O>) & {
     refresh(): Promise<void>;
     proposals(): ProposedProfileDiff[];
+    /** Flush buffered trace spans before a short-lived process exits. */
+    flush(): Promise<void>;
 };
 /**
  * Wrap an agent so it (a) RECEIVES the tenant's certified profile — the prompt
@@ -821,11 +928,11 @@ declare function withIntelligence<I, O>(agent: IntelligenceAgent<I, O>, config:
 
 /**
  *
- * Tangle Intelligence SDK — the Observe + Mode-0 product layer.
+ * Tangle Intelligence SDK — trace capture plus reviewable improvement.
  *
- * A thin, best-effort wrapper over the shipped trace-export substrate
- * (`createOtelExporter` in `../otel-export`). It does exactly two things in
- * this slice:
+ * The client keeps live-agent trace delivery best-effort. The separate
+ * improvement-cycle exports analyze completed traces, measure one candidate,
+ * bind human review, and execute only an approved immutable bundle.
  *
  *   1. OBSERVE — wrap a generic agent and export one trace span per call to
  *      Tangle Intelligence, swallowing every export failure so a live agent
@@ -836,11 +943,6 @@ declare function withIntelligence<I, O>(agent: IntelligenceAgent<I, O>, config:
  *      and at OFF `intelligenceUsd` is provably `0` — the mechanism that proves
  *      an OFF customer paid inference-only.
  *
- * Behavior-changing intelligence (analyst steer, candidate promotion, loops)
- * is a LATER phase and is NOT built here. This wrapper only Observes and passes
- * through; there is no abort path, so the only fail-soft surface is the
- * telemetry export.
- *
  * @experimental
  */
 
@@ -881,6 +983,30 @@ interface RunRecord {
     model?: string;
     provider?: string;
     loopEvents?: LoopTraceEvent[];
+    runtimeEvents?: RuntimeStreamEvent[];
+    profile?: AgentProfile;
+    sessionId?: string;
+    harness?: string;
+    repository?: string;
+    commitSha?: string;
+    timing?: {
+        startedAt: number;
+        completedAt: number;
+        durationMs: number;
+    };
+    tokens?: {
+        input: number;
+        output: number;
+        cachedInput?: number;
+        reasoning?: number;
+    };
+    error?: {
+        name: string;
+        message: string;
+        code?: string;
+    };
+    /** Exact proposal → review → execution → receipt linkage for candidate runs. */
+    candidateExecution?: CandidateExecutionEvidence;
 }
 /**
  * What an agent reports (via `applied.record`) to enrich the {@link RunRecord}
@@ -896,6 +1022,14 @@ interface RunReport {
     model?: string;
     provider?: string;
     loopEvents?: LoopTraceEvent[];
+    runtimeEvents?: RuntimeStreamEvent[];
+    profile?: AgentProfile;
+    sessionId?: string;
+    harness?: string;
+    commitSha?: string;
+    tokens?: RunRecord['tokens'];
+    error?: RunRecord['error'];
+    candidateExecution?: CandidateExecutionEvidence;
 }
 /** Repo coordinates a product may declare for the (later) Gated-PR mode. The
  *  Observe slice only records their PRESENCE for `doctor()`; it never touches
@@ -938,6 +1072,19 @@ interface IntelligenceConfig {
     checks?: string[];
     /** Repo access a later PR mode would need. Recorded for `doctor()` only. */
     repo?: RepoConfig;
+    /** Full canonical profile used for this agent. Exported redacted with a stable hash. */
+    profile?: AgentProfile;
+    /** Commit that produced the running agent, when known. */
+    commitSha?: string;
+    /** Runtime-event payload policy. Tool inputs/results remain off unless explicitly enabled. */
+    runtimeTelemetry?: RuntimeTelemetryOptions;
+    /**
+     * Payloads are metadata-only by default: the run span carries a stable hash
+     * and UTF-8 byte count, but not the redacted content. Set `full` only when
+     * the configured OTLP destination is approved to receive complete redacted
+     * inputs, outputs, and profiles.
+     */
+    payloadAttributes?: 'metadata' | 'full';
 }
 /** Metadata describing one traced run. `runId`/`traceId` default to fresh ids. */
 interface TraceMeta {
@@ -1068,4 +1215,4 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 
-export { type AppliedIntelligence, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CapabilitySurface, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type HostSpec, type IntelligenceAgent, type IntelligenceClient, type IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, type ModeReadiness, type ProposedProfileDiff, type ProvisionedHost, type PullCertifiedOptions, type PullOutcome, type RecordTraceMeta, type Redactor, type RepoConfig, type ResolveCtx, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type RunRecord, type RunReport, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createCertifiedPromptSource, createIntelligenceClient, defaultEffortTier, defaultRedactor, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, withIntelligence };
+export { type AgentImprovementEvaluation, type AgentImprovementProposal, type AgentImprovementReview, type AgentImprovementReviewDecision, type AppliedIntelligence, type CandidateExecutionEvidence, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CapabilitySurface, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExecuteApprovedAgentCandidateOptions, type ExecuteApprovedAgentCandidateResult, type HostSpec, type IntelligenceAgent, type IntelligenceClient, type IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, type ModeReadiness, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposedProfileDiff, type ProvisionedHost, type PullCertifiedOptions, type PullOutcome, type RecordTraceMeta, type Redactor, type RepoConfig, type ResolveCtx, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type ReviewAgentImprovementInput, type RunRecord, type RunReport, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createCertifiedPromptSource, createIntelligenceClient, defaultEffortTier, defaultRedactor, executeApprovedAgentCandidate, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, verifyAgentImprovementProposal, verifyAgentImprovementReview, withIntelligence };