@graphrefly/ts 0.0.0 → 0.0.2

package/dist/agent-runtime-types-core-CaXfKNtY.d.cts

@@ -0,0 +1,406 @@
+import { DataIssue } from './data/index.cjs';
+import { N as Node } from './types-BS6CyR-x.cjs';
+
+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>;
+}
+
+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 policyRefs?: readonly SourceRef[];
+    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 SizeCapacityEvidence {
+    readonly kind: "size-capacity-evidence";
+    readonly unit: string;
+    readonly quantity: number;
+    readonly measurementSource: string;
+    readonly estimated?: boolean;
+    readonly encoding?: string;
+    readonly mediaType?: string;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly refs?: readonly SourceRef[];
+    readonly issues?: readonly DataIssue[];
+    readonly sensitivity?: readonly string[];
+    readonly redaction?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+}
+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 artifacts?: readonly ExecutorArtifactMaterial[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface ExecutorArtifactMaterial<T = unknown> {
+    readonly kind: string;
+    readonly format?: string;
+    readonly schemaRef?: string;
+    readonly schemaKind?: string;
+    readonly mimeType?: string;
+    readonly mediaType?: string;
+    readonly filename?: string;
+    readonly byteLength?: number;
+    readonly digest?: string;
+    readonly encoding?: string;
+    readonly dataMode: "inline" | "summary" | "ref" | (string & {});
+    readonly summary?: string;
+    readonly value?: T;
+    readonly ref?: SourceRef;
+    readonly refs?: readonly SourceRef[];
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly sizeEvidence?: readonly SizeCapacityEvidence[];
+    readonly sensitivity?: readonly string[];
+    readonly redaction?: Record<string, unknown>;
+    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[];
+});
+
+export { type AgentRequestStatusChanged as A, type AgentDecisionFinal as B, type ContextContribution as C, type AgentDecisionKind as D, type ExecutorOutcome as E, type AgentRequestDeferred as F, type AgentRequestKind as G, type AgentRequestMerged as H, type AgentRequestRejected as I, type AgentRequestStatus as J, type AgentRequestViews as K, type EffectRunCompletionStatus as L, type EffectRunOptions as M, type EffectRunResultBase as N, type ExecutorArtifactMaterial as O, type PromptBundle as P, type SizeCapacityEvidence as Q, type StructuredAgentDecisionEnvelope as R, type SourceRef as S, effectRun as T, type AgentRuntimeAuditRecord as a, type AgentRequestFact as b, type ExecutorRoute as c, type AgentRequestIssued as d, type ExecutorProfile as e, type ExecutorOutcomeStatus as f, type AgentRequestInput as g, type AgentOutputEnvelope as h, type ExecutorUsage as i, type AgentNeed as j, type EffectRunResultStatus as k, type EffectRunGoal as l, type EffectRunLimits as m, type EffectRunResult as n, type EffectRun as o, type AgentDecision as p, type EffectRunCompletionBundle as q, type StructuredAgentDecisionInterpreterBundle as r, type ExecutorOutcomeBase as s, type AgentRequestProposal as t, type AgentRequestAdmitted as u, type AgentRequestLedgerBundle as v, type AgentDecisionContinue as w, type AgentRequestSatisfactionBundle as x, type AgentDecisionBase as y, type AgentDecisionBlocked as z };