@graphrefly/ts 0.0.0 → 0.0.1

package/dist/adapters/vue.d.ts

@@ -0,0 +1,26 @@
+import { ShallowRef } from 'vue';
+import { N as Node } from '../types-BsJvElYZ.js';
+import { W as WritableNode } from '../store-C-joM4gh.js';
+import '../messages-CAzUPPJM.js';
+
+/**
+ * Vue node bindings for GraphReFly (D238).
+ *
+ * Vue is imported only from this focused subpath.
+ */
+
+/** Read a GraphReFly node as a Vue shallow ref. */
+declare function useNodeValue<T>(node: Node<T>): Readonly<ShallowRef<T | undefined>>;
+/** Bind a writable GraphReFly node as `[valueRef, setValue]`. */
+declare function useNodeInput<T>(node: WritableNode<T>): readonly [Readonly<ShallowRef<T | undefined>>, (value: T) => void];
+/**
+ * Read a keyed record of nodes as a Vue shallow ref.
+ *
+ * `factory` must have stable identity; callers should define it outside render
+ * churn or memoize it in their composition function.
+ */
+declare function useNodeRecord<K extends string, R extends Record<string, unknown>>(keysNode: Node<readonly K[]>, factory: (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+}): Readonly<ShallowRef<Record<K, R>>>;
+
+export { useNodeInput, useNodeRecord, useNodeValue };

package/dist/adapters/vue.js

@@ -0,0 +1,46 @@
+import {
+  readableStore,
+  recordReadableStore
+} from "../chunk-H75VXTGT.js";
+import "../chunk-DGUM43GV.js";
+
+// src/adapters/vue.ts
+import { onScopeDispose, readonly, shallowRef } from "vue";
+function assertDataValue(value) {
+  if (value === void 0) {
+    throw new TypeError("useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value");
+  }
+}
+function bindReadable(store) {
+  const value = shallowRef(store.get());
+  const unsubscribe = store.subscribe((next) => {
+    value.value = next;
+  });
+  onScopeDispose(unsubscribe);
+  return readonly(value);
+}
+function useNodeValue(node) {
+  return bindReadable(readableStore(node));
+}
+function useNodeInput(node) {
+  return [
+    useNodeValue(node),
+    (value) => {
+      assertDataValue(value);
+      node.set(value);
+    }
+  ];
+}
+function useNodeRecord(keysNode, factory) {
+  const store = recordReadableStore(keysNode, factory);
+  return bindReadable({
+    get: () => store.get() ?? {},
+    subscribe: (run) => store.subscribe((value) => run(value ?? {}))
+  });
+}
+export {
+  useNodeInput,
+  useNodeRecord,
+  useNodeValue
+};
+//# sourceMappingURL=vue.js.map

package/dist/adapters/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/vue.ts"],"sourcesContent":["/**\n * Vue node bindings for GraphReFly (D238).\n *\n * Vue is imported only from this focused subpath.\n */\n\nimport { onScopeDispose, readonly, type ShallowRef, shallowRef } from \"vue\";\nimport type { Node } from \"../node/node.js\";\nimport { readableStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\"useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\");\n\t}\n}\n\nfunction bindReadable<T>(store: { get(): T; subscribe(run: (value: T) => void): () => void }) {\n\tconst value = shallowRef(store.get()) as ShallowRef<T>;\n\tconst unsubscribe = store.subscribe((next) => {\n\t\tvalue.value = next;\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn readonly(value) as Readonly<ShallowRef<T>>;\n}\n\n/** Read a GraphReFly node as a Vue shallow ref. */\nexport function useNodeValue<T>(node: Node<T>): Readonly<ShallowRef<T | undefined>> {\n\treturn bindReadable(readableStore(node));\n}\n\n/** Bind a writable GraphReFly node as `[valueRef, setValue]`. */\nexport function useNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [Readonly<ShallowRef<T | undefined>>, (value: T) => void] {\n\treturn [\n\t\tuseNodeValue(node),\n\t\t(value: T) => {\n\t\t\tassertDataValue(value);\n\t\t\tnode.set(value);\n\t\t},\n\t] as const;\n}\n\n/**\n * Read a keyed record of nodes as a Vue shallow ref.\n *\n * `factory` must have stable identity; callers should define it outside render\n * churn or memoize it in their composition function.\n */\nexport function useNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Readonly<ShallowRef<Record<K, R>>> {\n\tconst store = recordReadableStore(keysNode, factory);\n\treturn bindReadable({\n\t\tget: () => store.get() ?? ({} as Record<K, R>),\n\t\tsubscribe: (run) => store.subscribe((value) => run(value ?? ({} as Record<K, R>))),\n\t});\n}\n"],"mappings":";;;;;;;AAMA,SAAS,gBAAgB,UAA2B,kBAAkB;AAItE,SAAS,gBAAgB,OAAsB;AAC9C,MAAI,UAAU,QAAW;AACxB,UAAM,IAAI,UAAU,wEAAwE;AAAA,EAC7F;AACD;AAEA,SAAS,aAAgB,OAAqE;AAC7F,QAAM,QAAQ,WAAW,MAAM,IAAI,CAAC;AACpC,QAAM,cAAc,MAAM,UAAU,CAAC,SAAS;AAC7C,UAAM,QAAQ;AAAA,EACf,CAAC;AACD,iBAAe,WAAW;AAC1B,SAAO,SAAS,KAAK;AACtB;AAGO,SAAS,aAAgB,MAAoD;AACnF,SAAO,aAAa,cAAc,IAAI,CAAC;AACxC;AAGO,SAAS,aACf,MACqE;AACrE,SAAO;AAAA,IACN,aAAa,IAAI;AAAA,IACjB,CAAC,UAAa;AACb,sBAAgB,KAAK;AACrB,WAAK,IAAI,KAAK;AAAA,IACf;AAAA,EACD;AACD;AAQO,SAAS,cACf,UACA,SACqC;AACrC,QAAM,QAAQ,oBAAoB,UAAU,OAAO;AACnD,SAAO,aAAa;AAAA,IACnB,KAAK,MAAM,MAAM,IAAI,KAAM,CAAC;AAAA,IAC5B,WAAW,CAAC,QAAQ,MAAM,UAAU,CAAC,UAAU,IAAI,SAAU,CAAC,CAAkB,CAAC;AAAA,EAClF,CAAC;AACF;","names":[]}

package/dist/agent-runtime-BesGDZcB.d.ts

@@ -0,0 +1,555 @@
+import { DataIssue } from './data/index.js';
+import { d as Graph } from './graph-D-1-SQeC.js';
+import { N as Node } from './types-BsJvElYZ.js';
+
+interface SourceRef {
+    readonly kind: string;
+    readonly id: string;
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestInput<T = unknown> {
+    readonly inputId: string;
+    readonly inputKind: string;
+    readonly dataMode?: "ref" | "summary" | "inline";
+    readonly ref?: string;
+    readonly summary?: string;
+    readonly value?: T;
+    readonly schemaRef?: string;
+    readonly subjectRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface EffectRunGoal<TInput = unknown> {
+    readonly kind: string;
+    readonly summary?: string;
+    readonly detailRef?: string;
+    readonly input?: AgentRequestInput<TInput>;
+    readonly metadata?: Record<string, unknown>;
+}
+interface EffectRunLimits {
+    readonly maxSteps?: number;
+    readonly maxRequests?: number;
+    readonly maxAttemptsPerOperation?: number;
+    readonly maxPendingRequests?: number;
+    readonly maxCostUsd?: number;
+    readonly timeoutMs?: number;
+}
+interface EffectRun<TInput = unknown> {
+    readonly kind: "effect-run";
+    readonly effectRunId: string;
+    readonly agentRunId?: string;
+    readonly subjectRefs?: readonly SourceRef[];
+    readonly goal: EffectRunGoal<TInput>;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly policyRefs?: readonly SourceRef[];
+    readonly limits?: EffectRunLimits;
+    readonly createdBy?: string;
+    readonly createdAtMs?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+interface EffectRunOptions<TInput = unknown> {
+    readonly effectRunId: string;
+    readonly agentRunId?: string;
+    readonly subjectRefs?: readonly SourceRef[];
+    readonly goal: EffectRunGoal<TInput>;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly policyRefs?: readonly SourceRef[];
+    readonly limits?: EffectRunLimits;
+    readonly createdBy?: string;
+    readonly createdAtMs?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+declare function effectRun<TInput = unknown>(opts: EffectRunOptions<TInput>): EffectRun<TInput>;
+type AgentRequestKind = "context" | "prompt" | "executor";
+interface AgentRequestProposal<TPayload = unknown> {
+    readonly kind: "proposal";
+    readonly proposalId: string;
+    readonly effectRunId: string;
+    readonly agentRunId?: string;
+    readonly parentRequestId?: string;
+    readonly sourceDecisionId?: string;
+    readonly requestKind: AgentRequestKind;
+    readonly required?: boolean;
+    readonly subjectId?: string;
+    readonly input?: AgentRequestInput<TPayload>;
+    readonly payload?: TPayload;
+    readonly reason?: string;
+    readonly evidenceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestAdmitted {
+    readonly kind: "admitted";
+    readonly proposalId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly effectRunId: string;
+    readonly agentRunId?: string;
+    readonly admittedAtMs?: number;
+    readonly reason?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestRejected {
+    readonly kind: "rejected";
+    readonly proposalId: string;
+    readonly effectRunId: string;
+    readonly issue: DataIssue;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestDeferred {
+    readonly kind: "deferred";
+    readonly proposalId: string;
+    readonly effectRunId: string;
+    readonly reason?: string;
+    readonly untilRef?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestMerged {
+    readonly kind: "merged";
+    readonly proposalId: string;
+    readonly effectRunId: string;
+    readonly targetRequestId: string;
+    readonly reason?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestIssued<TPayload = unknown> {
+    readonly kind: "issued";
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly effectRunId: string;
+    readonly agentRunId?: string;
+    readonly proposalId?: string;
+    readonly parentRequestId?: string;
+    readonly requestKind: AgentRequestKind;
+    readonly required: boolean;
+    readonly input?: AgentRequestInput<TPayload>;
+    readonly payload?: TPayload;
+    readonly issuedAtMs?: number;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+type AgentRequestStatus = "proposed" | "admitted" | "rejected" | "deferred" | "merged" | "issued" | "awaiting-context" | "awaiting-prompt" | "awaiting-route" | "awaiting-provider" | "in-flight" | "completed" | "failed" | "blocked" | "canceled" | "timeout" | "waived" | "retry-exhausted";
+interface AgentRequestStatusChanged {
+    readonly kind: "status";
+    readonly requestId: string;
+    readonly operationId?: string;
+    readonly effectRunId: string;
+    readonly status: AgentRequestStatus;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly issues?: readonly DataIssue[];
+    readonly metadata?: Record<string, unknown>;
+}
+type AgentRequestFact<TPayload = unknown> = AgentRequestProposal<TPayload> | AgentRequestAdmitted | AgentRequestRejected | AgentRequestDeferred | AgentRequestMerged | AgentRequestIssued<TPayload> | AgentRequestStatusChanged;
+interface AgentRequestViews {
+    readonly requestsById: ReadonlyMap<string, AgentRequestIssued>;
+    readonly requestsByEffectRun: ReadonlyMap<string, readonly string[]>;
+    readonly statusByRequest: ReadonlyMap<string, AgentRequestStatusChanged>;
+    readonly pending: readonly AgentRequestIssued[];
+    readonly awaitingProvider: readonly AgentRequestIssued[];
+    readonly issues: readonly DataIssue[];
+    readonly audit: readonly AgentRuntimeAuditRecord[];
+}
+interface AgentRequestLedgerBundle {
+    readonly views: Node<AgentRequestViews>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+}
+interface ExecutorProfile {
+    readonly profileId: string;
+    readonly executorId: string;
+    readonly kind: "llm" | "tool" | "human" | "agent";
+    readonly acceptedInputKinds?: readonly string[];
+    readonly acceptedSchemaRefs?: readonly string[];
+    readonly acceptedResultKinds?: readonly string[];
+    readonly capabilities?: Record<string, unknown>;
+    readonly limits?: Record<string, number>;
+    readonly metadata?: Record<string, unknown>;
+}
+interface ExecutorRoute {
+    readonly kind: "executor-route";
+    readonly routeId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly inputId?: string;
+    readonly inputKind?: string;
+    readonly executorId: string;
+    readonly profileId: string;
+    readonly allowedParams?: Record<string, unknown>;
+    readonly reason?: string;
+    readonly evidenceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+type ExecutorOutcomeStatus = "result" | "failure" | "canceled" | "timeout" | "blocked";
+interface ExecutorUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly cacheHitTokens?: number;
+    readonly cacheMissTokens?: number;
+    readonly cacheWriteTokens?: number;
+    readonly cacheMode?: string;
+    readonly costUsd?: number;
+    readonly latencyMs?: number;
+}
+interface ExecutorOutcomeBase {
+    readonly kind: ExecutorOutcomeStatus;
+    readonly outcomeId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly routeId: string;
+    readonly executorId: string;
+    readonly profileId: string;
+    readonly attempt: number;
+    readonly inputId?: string;
+    readonly inputKind?: string;
+    readonly occurredAtMs?: number;
+    readonly evidenceRefs?: readonly SourceRef[];
+    readonly issues?: readonly DataIssue[];
+    readonly usage?: ExecutorUsage;
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentOutputEnvelope<T = unknown> {
+    readonly kind: string;
+    readonly value?: T;
+    readonly refs?: readonly SourceRef[];
+    readonly summary?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+type ExecutorOutcome<T = unknown> = (ExecutorOutcomeBase & {
+    readonly kind: "result";
+    readonly result: AgentOutputEnvelope<T>;
+}) | (ExecutorOutcomeBase & {
+    readonly kind: "failure";
+    readonly error: DataIssue;
+    readonly retryable?: boolean;
+}) | (ExecutorOutcomeBase & {
+    readonly kind: "canceled";
+    readonly reason?: string;
+}) | (ExecutorOutcomeBase & {
+    readonly kind: "timeout";
+    readonly timeoutMs?: number;
+    readonly retryable?: boolean;
+}) | (ExecutorOutcomeBase & {
+    readonly kind: "blocked";
+    readonly needs: readonly AgentNeed[];
+});
+/**
+ * Provider-neutral tool-call request input (D359). Concrete clients, secrets,
+ * transports, and SDK handles stay in executor adapter bindings, not this fact.
+ */
+interface ToolCallInput<TArguments = unknown> {
+    readonly kind: "tool-call";
+    readonly toolName: string;
+    readonly operation?: string;
+    readonly arguments?: TArguments;
+    readonly argumentsRef?: string;
+    readonly expectedOutput?: {
+        readonly resultKind?: string;
+        readonly schemaRef?: string;
+    };
+    readonly idempotency?: {
+        readonly key?: string;
+        readonly safeToRetry?: boolean;
+    };
+    readonly timeoutMs?: number;
+    readonly subjectRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Tool provider family label for optional Layer C adapters (D359). Builtin,
+ * MCP, CLI, and Composio providers stay executor/tool recipes, not WorkItem
+ * core or protocol semantics.
+ */
+type ToolProviderKind = "local-builtin" | "mcp" | "cli" | "composio" | (string & {});
+/**
+ * Graph-visible catalog entry for a tool exposed by an executor provider
+ * (D359). Runtime clients and credentials remain private adapter state.
+ */
+interface ToolProviderCatalogEntry {
+    readonly kind: "tool-catalog-entry";
+    readonly providerId: string;
+    readonly toolName: string;
+    readonly operation?: string;
+    readonly inputKind: "tool-call";
+    readonly profileId: string;
+    readonly executorId: string;
+    readonly resultKinds?: readonly string[];
+    readonly schemaRefs?: readonly string[];
+    readonly capabilities?: Record<string, unknown>;
+    readonly limits?: Record<string, number>;
+    readonly policyRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Graph-visible tool provider catalog/status surface (D359). This is passive
+ * DATA for routing/profile selection and UI inspection, not a provider runtime.
+ */
+interface ToolProviderCatalog {
+    readonly kind: "tool-provider-catalog";
+    readonly providerId: string;
+    readonly providerKind: ToolProviderKind;
+    readonly profiles: readonly ExecutorProfile[];
+    readonly tools: readonly ToolProviderCatalogEntry[];
+    readonly status?: "ready" | "unavailable" | "misconfigured";
+    readonly issues?: readonly DataIssue[];
+    readonly audit?: readonly AgentRuntimeAuditRecord[];
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Options for producing a local builtin tool-provider catalog (D359). Limits and
+ * capabilities are declarative policy hints; execution remains adapter-owned.
+ */
+interface LocalBuiltinToolProviderCatalogOptions {
+    readonly providerId?: string;
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly tools?: readonly Omit<ToolProviderCatalogEntry, "kind" | "providerId" | "inputKind" | "profileId" | "executorId">[];
+    readonly limits?: Record<string, number>;
+    readonly capabilities?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Audience selector for bounded ExecutorOutcome projections (D359).
+ */
+type ExecutorOutcomeViewAudience = "agent-observation" | "ui" | "diagnostic" | "audit";
+/**
+ * View policy for deriving bounded, audience-specific ExecutorOutcome summaries
+ * (D359/D270/D293) without inlining large/raw provider material.
+ */
+interface ExecutorOutcomeViewPolicy {
+    readonly audience?: ExecutorOutcomeViewAudience;
+    readonly maxSummaryChars?: number;
+    readonly includeIssues?: boolean;
+    readonly includeUsage?: boolean;
+    readonly includeMetadata?: boolean;
+}
+/**
+ * Bounded projection of ExecutorOutcome for agent, UI, diagnostic, or audit
+ * consumers (D359). Large/raw material stays behind refs.
+ */
+interface ExecutorOutcomeView {
+    readonly kind: "executor-outcome-view";
+    readonly viewId: string;
+    readonly audience: ExecutorOutcomeViewAudience;
+    readonly outcomeId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly routeId: string;
+    readonly executorId: string;
+    readonly profileId: string;
+    readonly status: ExecutorOutcomeStatus;
+    readonly summary: string;
+    readonly summaryTruncated?: boolean;
+    readonly summaryChars?: number;
+    readonly summaryLimitChars?: number;
+    readonly errorKind?: string;
+    readonly retryable?: boolean;
+    readonly nextActions?: readonly string[];
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly materialRefs?: readonly SourceRef[];
+    readonly issues?: readonly DataIssue[];
+    readonly usage?: ExecutorUsage;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Output bundle for ExecutorOutcome view projectors (D359).
+ */
+interface ExecutorOutcomeViewBundle {
+    readonly views: Node<ExecutorOutcomeView>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+}
+interface ContextContribution {
+    readonly kind: "context-contribution";
+    readonly contributionId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly status: "ready" | "pending" | "issue";
+    readonly frameId?: string;
+    readonly issues?: readonly DataIssue[];
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface PromptBundle {
+    readonly kind: "prompt-bundle";
+    readonly promptId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly status: "ready" | "partial" | "issue";
+    readonly sourceFrameIds?: readonly string[];
+    readonly issues?: readonly DataIssue[];
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentRequestSatisfactionBundle {
+    readonly status: Node<AgentRequestStatusChanged>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+}
+type AgentDecisionKind = "continue" | "final" | "blocked";
+interface AgentNeed {
+    readonly kind: string;
+    readonly message?: string;
+    readonly refs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentDecisionBase {
+    readonly kind: AgentDecisionKind;
+    readonly decisionId: string;
+    readonly effectRunId: string;
+    readonly agentRunId: string;
+    readonly source: {
+        readonly requestId: string;
+        readonly operationId: string;
+        readonly outcomeId: string;
+    };
+    readonly reason?: string;
+    readonly confidence?: number;
+    readonly evidenceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface AgentDecisionContinue extends AgentDecisionBase {
+    readonly kind: "continue";
+    readonly next: readonly AgentRequestProposal[];
+}
+interface AgentDecisionFinal extends AgentDecisionBase {
+    readonly kind: "final";
+    readonly output: AgentOutputEnvelope;
+    readonly summary?: string;
+}
+interface AgentDecisionBlocked extends AgentDecisionBase {
+    readonly kind: "blocked";
+    readonly needs: readonly AgentNeed[];
+}
+type AgentDecision = AgentDecisionContinue | AgentDecisionFinal | AgentDecisionBlocked;
+interface StructuredAgentDecisionEnvelope {
+    readonly kind: "agent-decision";
+    readonly decision: AgentDecision;
+    readonly schemaRef: string;
+    readonly sourceRefs?: readonly SourceRef[];
+}
+interface StructuredAgentDecisionInterpreterBundle {
+    readonly decisions: Node<AgentDecision>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+}
+type EffectRunResultStatus = "completed" | "failed" | "blocked" | "canceled" | "timeout" | "waived";
+interface EffectRunResultBase {
+    readonly kind: "effect-run-result";
+    readonly resultId: string;
+    readonly status: EffectRunResultStatus;
+    readonly effectRunId: string;
+    readonly subjectRefs?: readonly SourceRef[];
+    readonly operationId?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly issues?: readonly DataIssue[];
+    readonly auditRefs?: readonly string[];
+    readonly completedAtMs?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+type EffectRunResult = (EffectRunResultBase & {
+    readonly status: "completed";
+    readonly output: AgentOutputEnvelope;
+}) | (EffectRunResultBase & {
+    readonly status: "failed";
+    readonly error: DataIssue;
+}) | (EffectRunResultBase & {
+    readonly status: "blocked";
+    readonly needs: readonly AgentNeed[];
+}) | (EffectRunResultBase & {
+    readonly status: "canceled";
+    readonly reason?: string;
+}) | (EffectRunResultBase & {
+    readonly status: "timeout";
+    readonly timeoutMs?: number;
+}) | (EffectRunResultBase & {
+    readonly status: "waived";
+    readonly reason?: string;
+});
+interface EffectRunCompletionBundle {
+    readonly results: Node<EffectRunResult>;
+    readonly status: Node<EffectRunCompletionStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+}
+interface EffectRunCompletionStatus {
+    readonly effectRunId: string;
+    readonly state: "pending" | "completed" | "failed" | "blocked" | "canceled" | "timeout" | "waived";
+    readonly requiredPending: readonly string[];
+    readonly requiredTerminal: readonly string[];
+    readonly sourceRefs?: readonly SourceRef[];
+}
+interface AgentRuntimeAuditRecord {
+    readonly id: string;
+    readonly kind: string;
+    readonly subjectId?: string;
+    readonly message?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly issueCode?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+declare function agentRequestProposalFromDecision(decision: AgentDecisionContinue, proposal: Omit<AgentRequestProposal, "kind" | "effectRunId" | "agentRunId" | "sourceDecisionId">): AgentRequestProposal;
+declare function admitAgentRequestProposal(proposal: AgentRequestProposal, opts: {
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly admittedAtMs?: number;
+    readonly reason?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}): AgentRequestAdmitted;
+declare function issueAgentRequest(proposal: AgentRequestProposal, admission: AgentRequestAdmitted, opts?: {
+    readonly issuedAtMs?: number;
+    readonly sourceRefs?: readonly SourceRef[];
+}): AgentRequestIssued;
+declare function agentRequestLedgerViews(graph: Graph, facts: Node<AgentRequestFact>, opts?: {
+    readonly name?: string;
+}): AgentRequestLedgerBundle;
+declare function requestSatisfactionProjector(graph: Graph, opts: {
+    readonly name?: string;
+    readonly requestFacts: Node<AgentRequestFact>;
+    readonly executorProfiles?: readonly Node<ExecutorProfile>[];
+    readonly executorRoutes?: readonly Node<ExecutorRoute>[];
+    readonly executorOutcomes?: readonly Node<ExecutorOutcome>[];
+    readonly contextContributions?: readonly Node<ContextContribution>[];
+    readonly promptBundles?: readonly Node<PromptBundle>[];
+}): AgentRequestSatisfactionBundle;
+declare function localBuiltinToolProviderCatalog(opts?: LocalBuiltinToolProviderCatalogOptions): ToolProviderCatalog;
+declare function executorOutcomeViewProjector(graph: Graph, opts: {
+    readonly name?: string;
+    readonly outcomes: Node<ExecutorOutcome>;
+    readonly policy?: ExecutorOutcomeViewPolicy;
+}): ExecutorOutcomeViewBundle;
+declare function structuredAgentDecisionInterpreter(graph: Graph, outcomes: Node<ExecutorOutcome>, opts?: {
+    readonly name?: string;
+    readonly schemaRef?: string;
+    readonly requestFacts?: readonly Node<AgentRequestFact>[];
+}): StructuredAgentDecisionInterpreterBundle;
+declare function effectRunCompletionProjector(graph: Graph, opts: {
+    readonly name?: string;
+    readonly effectRuns: Node<EffectRun>;
+    readonly decisions?: readonly Node<AgentDecision>[];
+    readonly requestStatuses?: readonly Node<AgentRequestStatusChanged>[];
+    readonly requestFacts?: readonly Node<AgentRequestFact>[];
+    readonly resultCandidates?: readonly Node<EffectRunResult>[];
+    readonly now?: () => number;
+}): EffectRunCompletionBundle;
+declare function fakeExecutorResult<T>(opts: Omit<ExecutorOutcomeBase, "kind"> & {
+    readonly result: AgentOutputEnvelope<T>;
+}): ExecutorOutcome<T>;
+declare function fakeExecutorFailure(opts: Omit<ExecutorOutcomeBase, "kind"> & {
+    readonly error: DataIssue;
+    readonly retryable?: boolean;
+}): ExecutorOutcome;
+declare function fakeExecutorBlocked(opts: Omit<ExecutorOutcomeBase, "kind"> & {
+    readonly needs: readonly AgentNeed[];
+}): ExecutorOutcome;
+declare function fakeExecutorTimeout(opts: Omit<ExecutorOutcomeBase, "kind"> & {
+    readonly timeoutMs?: number;
+    readonly retryable?: boolean;
+}): ExecutorOutcome;
+declare function fakeExecutorCanceled(opts: Omit<ExecutorOutcomeBase, "kind"> & {
+    readonly reason?: string;
+}): ExecutorOutcome;
+
+export { agentRequestLedgerViews as $, type AgentRequestIssued as A, type EffectRunLimits as B, type ContextContribution as C, type EffectRunOptions as D, type ExecutorOutcome as E, type EffectRunResult as F, type EffectRunResultBase as G, type EffectRunResultStatus as H, type ExecutorOutcomeBase as I, type ExecutorOutcomeStatus as J, type ExecutorOutcomeView as K, type ExecutorOutcomeViewAudience as L, type ExecutorOutcomeViewBundle as M, type ExecutorOutcomeViewPolicy as N, type ExecutorProfile as O, type ExecutorRoute as P, type ExecutorUsage as Q, type LocalBuiltinToolProviderCatalogOptions as R, type SourceRef as S, type PromptBundle as T, type StructuredAgentDecisionEnvelope as U, type StructuredAgentDecisionInterpreterBundle as V, type ToolCallInput as W, type ToolProviderCatalog as X, type ToolProviderCatalogEntry as Y, type ToolProviderKind as Z, admitAgentRequestProposal as _, type AgentDecision as a, agentRequestProposalFromDecision as a0, effectRun as a1, effectRunCompletionProjector as a2, executorOutcomeViewProjector as a3, fakeExecutorBlocked as a4, fakeExecutorCanceled as a5, fakeExecutorFailure as a6, fakeExecutorResult as a7, fakeExecutorTimeout as a8, issueAgentRequest as a9, localBuiltinToolProviderCatalog as aa, requestSatisfactionProjector as ab, structuredAgentDecisionInterpreter as ac, type AgentDecisionBase as b, type AgentDecisionBlocked as c, type AgentDecisionContinue as d, type AgentDecisionFinal as e, type AgentDecisionKind as f, type AgentNeed as g, type AgentOutputEnvelope as h, type AgentRequestAdmitted as i, type AgentRequestDeferred as j, type AgentRequestFact as k, type AgentRequestInput as l, type AgentRequestKind as m, type AgentRequestLedgerBundle as n, type AgentRequestMerged as o, type AgentRequestProposal as p, type AgentRequestRejected as q, type AgentRequestSatisfactionBundle as r, type AgentRequestStatus as s, type AgentRequestStatusChanged as t, type AgentRequestViews as u, type AgentRuntimeAuditRecord as v, type EffectRun as w, type EffectRunCompletionBundle as x, type EffectRunCompletionStatus as y, type EffectRunGoal as z };