@tangle-network/braid 0.1.0

package/dist/app/application-types.d.ts

@@ -0,0 +1,83 @@
+import type { BraidControlKind, BraidEventEnvelope } from '../domain/events.js';
+import type { ContextTransferReceipt, NativeContextBoundaryProof, PortableContextPlan, RunAdmissionReceipt } from '../domain/receipts.js';
+import type { BraidState, RunStatus } from '../domain/state.js';
+import type { ControlAcknowledgement } from '../ports/execution.js';
+export type AppSubscriber = (state: BraidState, envelope: BraidEventEnvelope) => void;
+export interface SendInput {
+    readonly operationId: string;
+    readonly text: string;
+    readonly conversationId?: string;
+    readonly branchId?: string;
+    readonly sessionId?: string;
+    readonly contextPlan?: PortableContextPlan;
+    readonly contextTransfer?: ContextTransferReceipt;
+    readonly nativeContextBoundaryProof?: NativeContextBoundaryProof;
+}
+export interface SendReceipt {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly revision: number;
+    readonly replayed: boolean;
+    readonly admission: RunAdmissionReceipt;
+    /** Resolves when admission and run.requested are durably committed. */
+    readonly admissionReady?: Promise<void>;
+    readonly completion: Promise<BraidState>;
+}
+export interface QueueReceipt {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly position: number;
+    readonly revision: number;
+    readonly completion?: Promise<void>;
+}
+export interface ControlReceipt {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly control: BraidControlKind;
+    readonly acknowledgement: ControlAcknowledgement;
+    readonly status: RunStatus;
+    readonly completion: Promise<BraidState>;
+}
+export interface ShutdownReceipt {
+    readonly operationId: string;
+    readonly revision: number;
+    readonly replayed: boolean;
+    readonly outcome?: 'idle' | 'detached' | 'cancelled' | 'waiting';
+    readonly runId?: string;
+    readonly state?: BraidState;
+    readonly completion: Promise<BraidState>;
+}
+export interface ShutdownRecord {
+    readonly digest: string;
+    readonly completion: Promise<BraidState>;
+}
+export interface OperationRecord {
+    readonly digest: string;
+    readonly runId: string;
+    readonly admission: RunAdmissionReceipt;
+    completion: Promise<unknown>;
+}
+export interface ControlOperationRecord {
+    readonly digest: string;
+    readonly runId: string;
+    readonly control: BraidControlKind;
+    readonly completion: Promise<BraidState>;
+    readonly acknowledgement: Promise<ControlAcknowledgement>;
+    /** Resolves after the bounded foreground result has been durably recorded. */
+    readonly lateSettlementReady?: Promise<void>;
+    /** Coalesces duplicate late provider callbacks for one operation. */
+    readonly lateSettlement?: Promise<void>;
+    readonly providerSessionId?: string;
+    readonly reason?: string;
+    readonly text?: string;
+    readonly cursor?: string;
+}
+export interface InteractionReceipt {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly interactionId: string;
+    readonly replayed: boolean;
+    readonly acknowledgement: ControlAcknowledgement;
+    readonly completion: Promise<BraidState>;
+}
+//# sourceMappingURL=application-types.d.ts.map

package/dist/app/application-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-types.d.ts","sourceRoot":"","sources":["../../src/app/application-types.ts"],"names":[],"mappings":"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"}

package/dist/app/application-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application-types.js.map

package/dist/app/application-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-types.js","sourceRoot":"","sources":["../../src/app/application-types.ts"],"names":[],"mappings":""}

package/dist/app/application.d.ts

@@ -0,0 +1,83 @@
+import type { InteractionResponse } from '@tangle-network/agent-interface';
+import type { BraidEventEnvelope } from '../domain/events.js';
+import type { ContextTransferReceipt, NativeContextBoundaryProof, RunAdmissionReceipt } from '../domain/receipts.js';
+import type { RuntimeEventEnvelope } from '../domain/runtime-events.js';
+import { type BraidState } from '../domain/state.js';
+import type { ExecuteTurnInput } from '../ports/execution.js';
+import type { BraidApplicationOptions, CancelInput, CancelReceipt } from './application-options.js';
+import type { ReconnectInput, RuntimeEventIngestionResult } from './application-ports.js';
+import type { AppSubscriber, ControlReceipt, InteractionReceipt, QueueReceipt, SendInput, SendReceipt, ShutdownReceipt } from './application-types.js';
+import type { AutomationActions } from './automation-actions.js';
+import type { ConversationActions } from './conversations.js';
+import { type IntelligenceActions } from './intelligence-actions.js';
+export type { SendInput, SendReceipt } from './application-types.js';
+export { AppError } from './errors.js';
+import { type ConfigurationActionTransition } from './configuration-action-transition.js';
+import { RuntimeSelection } from './runtime-selection.js';
+export type { BraidApplicationOptions, CancelInput, CancelReceipt } from './application-options.js';
+export declare class BraidApplication {
+    #private;
+    readonly conversations: ConversationActions;
+    readonly intelligence: IntelligenceActions;
+    readonly automation: AutomationActions;
+    readonly configuration: ConfigurationActionTransition;
+    readonly runtimeSelection: RuntimeSelection;
+    constructor(options: BraidApplicationOptions);
+    state(): BraidState;
+    revision(): number;
+    events(): readonly BraidEventEnvelope[];
+    storageFailure(): string | undefined;
+    cleanupUncertain(): string | undefined;
+    markCleanupUncertain(reason: string): void;
+    whenDurable(): Promise<void>;
+    subscribe(subscriber: AppSubscriber): () => void;
+    initialize(workspace: string): BraidState;
+    send(input: SendInput): SendReceipt;
+    queueInput(input: {
+        readonly operationId: string;
+        readonly text: string;
+        readonly runId?: string;
+    }): QueueReceipt;
+    steer(input: {
+        readonly operationId: string;
+        readonly runId?: string;
+        readonly text: string;
+    }): Promise<ControlReceipt>;
+    cancelRun(input: {
+        readonly operationId: string;
+        readonly runId?: string;
+        readonly reason?: string;
+        readonly terminalStatus?: 'cancelled' | 'aborted';
+        readonly legacy?: boolean;
+    }): Promise<ControlReceipt>;
+    cancel(input: CancelInput): CancelReceipt;
+    cancelActive(): boolean;
+    canCancel(): boolean;
+    canRespondToInteractions(): boolean;
+    detachRun(input: {
+        readonly operationId: string;
+        readonly runId?: string;
+    }): Promise<ControlReceipt>;
+    respondInteraction(input: {
+        readonly operationId: string;
+        readonly runId: string;
+        readonly interactionId: string;
+        readonly response: InteractionResponse;
+    }): Promise<InteractionReceipt>;
+    reconnectRun(input: ReconnectInput): Promise<BraidState>;
+    reconcileRun(input: ReconnectInput): Promise<BraidState>;
+    continueNative(input: {
+        readonly operationId: string;
+        readonly text: string;
+        readonly runId?: string;
+    }): Promise<SendReceipt>;
+    shutdown(input: {
+        readonly operationId: string;
+        readonly mode?: 'wait' | 'detach' | 'cancel';
+    }): ShutdownReceipt;
+    waitForIdle(): Promise<BraidState>;
+    close(): Promise<void>;
+    ingestRuntimeEvent(envelope: RuntimeEventEnvelope): RuntimeEventIngestionResult;
+    admit(input: ExecuteTurnInput, conversationId: string, branchId: string, contextTransfer?: ContextTransferReceipt, turnId?: string, contextPlanDigest?: string, nativeContextBoundaryProof?: NativeContextBoundaryProof): RunAdmissionReceipt;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/app/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/app/application.ts"],"names":[],"mappings":"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"}