@qduc/term2 0.14.0 → 0.15.0

package/dist/gateway/gateway.d.ts

@@ -0,0 +1,72 @@
+import { createGatewayAssertion } from './assertion.js';
+import { GatewayLifecycle } from './lifecycle.js';
+import { WorkspaceAdmission, type WorkspaceBoundaryProbe } from './workspace-admission.js';
+import { composeGatewaySession, type GatewaySessionCompositionOptions, type WorkerBoundaryProbe } from './worker-boundary.js';
+import type { GatewayAssertionClaims, GatewayManifest, GatewaySafeLogMetadata, ProviderBrokerCapability, SessionBinding } from './contracts.js';
+import { GatewayServer } from './server.js';
+import type { RuntimeFactory } from './runtime-factory.js';
+import { type PendingInteractionDto, type SessionProjectionSource } from './persistence/projection.js';
+import { ServerSession } from './server-session.js';
+import type { GatewayPersistenceCoordinator } from './persistence/coordinator.js';
+declare const INTERACTION_METRICS: readonly ['interaction_presented', 'interaction_updated', 'interaction_resolved', 'interaction_stale', 'interaction_duplicate', 'interaction_sanitization_rejected', 'interaction_continuation_failed'];
+type InteractionMetric = (typeof INTERACTION_METRICS)[number];
+export type GatewayLaunchConfig = {
+    enabled: boolean;
+    socketPath: string;
+    manifestPath: string;
+    manifestSha256?: string;
+    replayDbPath: string;
+    issuer: string;
+    audience: string;
+    publicKeys: ReadonlyMap<string, string | Buffer> | Record<string, string | Buffer>;
+    providerBroker?: ProviderBrokerCapability;
+    providerProbe?: WorkerBoundaryProbe;
+    workerSandboxAvailable?: boolean;
+    workspaceBoundaryProbe?: WorkspaceBoundaryProbe;
+    tmpDir?: string;
+    sshEnabled?: boolean;
+    allowWrite?: boolean;
+    autoApprove?: boolean;
+    allowUnsandboxed?: boolean;
+    auditWriter?: (record: GatewaySafeLogMetadata) => Promise<void>;
+    /** Required for production admission; retained optional for legacy control-plane fixtures. */
+    runtimeFactory?: RuntimeFactory;
+    /** Optional plan-03 durable index/log/journal owner. */
+    persistence?: GatewayPersistenceCoordinator;
+};
+export declare class GatewayStartupError extends Error {
+    constructor();
+}
+export declare function assertGatewayStartup(config: GatewayLaunchConfig, manifest?: GatewayManifest): GatewayManifest;
+/** Gateway control plane. Runtime/session protocols remain private RPC consumers. */
+export declare class Term2Gateway {
+    #private;
+    private constructor();
+    static create(config: GatewayLaunchConfig): Term2Gateway;
+    get server(): GatewayServer;
+    get admission(): WorkspaceAdmission;
+    get lifecycle(): GatewayLifecycle;
+    get manifestVersion(): number;
+    get interactionMetrics(): Readonly<Record<InteractionMetric, number>>;
+    start(): Promise<void>;
+    createSession(claims: GatewayAssertionClaims, options?: Omit<GatewaySessionCompositionOptions, 'binding' | 'providerBroker' | 'providerProbe'>, correlationId?: string): Promise<ReturnType<typeof composeGatewaySession> | ServerSession>;
+    shutdown(graceMs?: number): Promise<void>;
+}
+export declare function classifyInteractionResolution(interaction: SessionProjectionSource['interaction'], hasLiveSnapshot: boolean): 'interaction_not_resolvable' | 'interaction_already_resolved' | null;
+export type InteractionResolveRequest = {
+    revision: number;
+    answer: string;
+    rejectionReason?: string;
+    approvalAnswer?: string;
+};
+export declare function isInteractionResolveRequest(body: unknown): body is InteractionResolveRequest;
+declare function isPublicEventEnvelope(event: import('./persistence/contracts.js').AgentEventEnvelope): boolean;
+declare function interactionDtoFromSnapshot(snapshot: {
+    interactionId?: number;
+    approval: unknown;
+    askUserAnswers: readonly unknown[];
+    currentAskUserQuestionIndex: number;
+}, interactionId: string, revision: number): PendingInteractionDto;
+export { createGatewayAssertion, interactionDtoFromSnapshot, isPublicEventEnvelope };
+export type { SessionBinding };
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway/gateway.d.ts.map

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