@sayknow-cli/bridge-client 0.3.16 → 0.4.1

package/dist/types/index.d.ts

@@ -1,156 +0,0 @@
-import type { BridgeClientCommand, BridgeCommandHelpers, BridgeCommandOptions } from "./commands";
-import type { BridgeFrame } from "./reference-consumer";
-export * from "./commands";
-export * from "./reference-consumer";
-export * from "./workflow-gate";
-import type { UnattendedDeclaration, WorkflowGate, WorkflowGateResolver } from "./workflow-gate";
-export type BridgeCapability = "events" | "prompt" | "permission" | "elicitation" | "ui.declarative" | "ui.editor" | "ui.terminal_input" | "host_tools" | "host_uri" | "client_bridge.read_text_file" | "client_bridge.write_text_file" | "client_bridge.create_terminal" | "workflow_gate";
-export type BridgeCommandScope = "prompt" | "control" | "bash" | "export" | "session" | "model" | "message:read" | "host_tools" | "host_uri" | "admin";
-export interface BridgeProtocolRange {
-    min: number;
-    max: number;
-}
-export interface BridgeHandshakeRequest {
-    protocol_version_range: BridgeProtocolRange;
-    capabilities: BridgeCapability[];
-    requested_scopes: BridgeCommandScope[];
-    last_seq?: number;
-    unattended?: UnattendedDeclaration;
-}
-export interface BridgeHandshakeAccepted {
-    status: "accepted";
-    protocol_version: number;
-    session_id: string;
-    accepted_capabilities: BridgeCapability[];
-    accepted_scopes: BridgeCommandScope[];
-    unsupported: BridgeCapability[];
-    endpoints: {
-        events: string;
-        commands: string;
-        uiResponses: string;
-        claimControl: string;
-        hostToolResults: string;
-        disconnectControl: string;
-        hostUriResults: string;
-    };
-    frame_types: string[];
-    accepted_unattended?: UnattendedDeclaration;
-}
-export interface BridgeHandshakeRejected {
-    status: "rejected";
-    reason: "incompatible_version" | "unauthorized" | "invalid_request";
-    message: string;
-}
-export type BridgeFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-export type BridgeHandshakeResponse = BridgeHandshakeAccepted | BridgeHandshakeRejected;
-export interface BridgeClientOptions {
-    baseUrl: string;
-    token: string;
-    fetch?: BridgeFetch;
-    allowInsecureLocalhost?: boolean;
-}
-export declare class BridgeClient implements BridgeCommandHelpers {
-    #private;
-    constructor(options: BridgeClientOptions);
-    handshake(request: BridgeHandshakeRequest): Promise<BridgeHandshakeResponse>;
-    command(command: BridgeClientCommand, sessionId: string, idempotencyKey: string): Promise<unknown>;
-    prompt(sessionId: string, message: string, options?: {
-        id?: string;
-        images?: unknown[];
-        streamingBehavior?: "steer" | "followUp";
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    steer(sessionId: string, message: string, options?: {
-        id?: string;
-        images?: unknown[];
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    followUp(sessionId: string, message: string, options?: {
-        id?: string;
-        images?: unknown[];
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    bash(sessionId: string, command: string, options?: {
-        id?: string;
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    getState(sessionId: string, options?: {
-        id?: string;
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    getMessages(sessionId: string, options?: {
-        id?: string;
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    abort(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    abortAndPrompt(sessionId: string, message: string, options?: {
-        id?: string;
-        images?: unknown[];
-        idempotencyKey?: string;
-    }): Promise<unknown>;
-    newSession(sessionId: string, options?: BridgeCommandOptions & {
-        parentSession?: string;
-    }): Promise<unknown>;
-    setTodos(sessionId: string, phases: unknown[], options?: BridgeCommandOptions): Promise<unknown>;
-    setHostTools(sessionId: string, tools: unknown[], options?: BridgeCommandOptions): Promise<unknown>;
-    setHostUriSchemes(sessionId: string, schemes: unknown[], options?: BridgeCommandOptions): Promise<unknown>;
-    getPendingWorkflowGates(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    setModel(sessionId: string, provider: string, modelId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    cycleModel(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    getAvailableModels(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    setThinkingLevel(sessionId: string, level: string, options?: BridgeCommandOptions): Promise<unknown>;
-    cycleThinkingLevel(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    setSteeringMode(sessionId: string, mode: "all" | "one-at-a-time", options?: BridgeCommandOptions): Promise<unknown>;
-    setFollowUpMode(sessionId: string, mode: "all" | "one-at-a-time", options?: BridgeCommandOptions): Promise<unknown>;
-    setInterruptMode(sessionId: string, mode: "immediate" | "wait", options?: BridgeCommandOptions): Promise<unknown>;
-    compact(sessionId: string, options?: BridgeCommandOptions & {
-        customInstructions?: string;
-    }): Promise<unknown>;
-    setAutoCompaction(sessionId: string, enabled: boolean, options?: BridgeCommandOptions): Promise<unknown>;
-    setAutoRetry(sessionId: string, enabled: boolean, options?: BridgeCommandOptions): Promise<unknown>;
-    abortRetry(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    abortBash(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    getSessionStats(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    exportHtml(sessionId: string, options?: BridgeCommandOptions & {
-        outputPath?: string;
-    }): Promise<unknown>;
-    switchSession(sessionId: string, sessionPath: string, options?: BridgeCommandOptions): Promise<unknown>;
-    branch(sessionId: string, entryId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    getBranchMessages(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    getLastAssistantText(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    setSessionName(sessionId: string, name: string, options?: BridgeCommandOptions): Promise<unknown>;
-    handoff(sessionId: string, options?: BridgeCommandOptions & {
-        customInstructions?: string;
-    }): Promise<unknown>;
-    getLoginProviders(sessionId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    login(sessionId: string, providerId: string, options?: BridgeCommandOptions): Promise<unknown>;
-    createIdempotencyKey(prefix?: string): string;
-    events(sessionId: string, lastSeq?: number): AsyncGenerator<BridgeFrame>;
-    claimControl(sessionId: string, ownerToken?: string): Promise<unknown>;
-    disconnectControl(sessionId: string, ownerToken: string): Promise<unknown>;
-    respondToUiRequest(sessionId: string, correlationId: string, ownerToken: string, response: unknown, idempotencyKey?: string): Promise<unknown>;
-    /**
-     * Answer a `workflow_gate` by posting to the UI-response endpoint and return
-     * the gate resolution envelope. Authorization is bearer auth plus the
-     * `control` scope; `ownerToken` is carried for idempotency/controller
-     * correlation, not as the gate authorization boundary.
-     */
-    respondGate(sessionId: string, gateId: string, ownerToken: string, answer: unknown, options?: {
-        idempotencyKey?: string;
-        id?: string;
-    }): Promise<unknown>;
-    /**
-     * Headless policy: stream the session's frames, route every received
-     * `workflow_gate` to the agent `resolver`, and post its answer back. Yields
-     * each handled gate. The resolver supplies the agent's memory-backed answer.
-     */
-    consumeWorkflowGates(sessionId: string, ownerToken: string, resolver: WorkflowGateResolver, options?: {
-        lastSeq?: number;
-    }): AsyncGenerator<{
-        gate: WorkflowGate;
-        answer: unknown;
-    }>;
-    respondToHostTool(sessionId: string, correlationId: string, result: unknown): Promise<unknown>;
-    respondToHostUri(sessionId: string, correlationId: string, result: unknown): Promise<unknown>;
-    connectEvents(sessionId: string, lastSeq?: number): Promise<Response>;
-}

package/dist/types/reference-consumer.d.ts

@@ -1,20 +0,0 @@
-export interface BridgeFrame<TPayload = unknown> {
-    protocol_version: number;
-    session_id: string;
-    seq: number;
-    frame_id: string;
-    correlation_id?: string;
-    type: string;
-    payload: TPayload;
-}
-export interface RenderedBridgeFrame {
-    seq: number;
-    type: string;
-    html: string;
-}
-export declare function renderBridgeFrame(frame: BridgeFrame): RenderedBridgeFrame;
-export declare class ReferenceBridgeConsumer {
-    #private;
-    consume(frame: BridgeFrame): RenderedBridgeFrame;
-    renderDocument(): string;
-}

package/dist/types/workflow-gate.d.ts

@@ -1,49 +0,0 @@
-/**
- * Typed `workflow_gate` client helpers (#322).
- *
- * Mirrors the server-side workflow-gate contract for bridge consumers: a typed
- * gate frame, the response shape, a frame type-guard, and a headless policy that
- * routes received gates to an agent callback and posts answers back through the
- * existing owner-token ui-response flow.
- */
-import type { BridgeFrame } from "./reference-consumer";
-export type WorkflowGateStage = "deep-interview" | "ralplan" | "ultragoal";
-export type WorkflowGateKind = "question" | "approval" | "execution";
-export interface WorkflowGateOption {
-    value: unknown;
-    label: string;
-    description?: string;
-}
-export interface WorkflowGate {
-    type: "workflow_gate";
-    gate_id: string;
-    stage: WorkflowGateStage;
-    kind: WorkflowGateKind;
-    schema: unknown;
-    schema_hash: string;
-    options?: WorkflowGateOption[];
-    context: Record<string, unknown>;
-    created_at: string;
-    required: true;
-}
-export interface WorkflowGateResponse {
-    gate_id: string;
-    answer: unknown;
-    idempotency_key?: string;
-}
-/** Unattended declaration carried on the bridge handshake (#318/#319). */
-export interface UnattendedDeclaration {
-    actor: string;
-    budget: {
-        max_tokens: number;
-        max_tool_calls: number;
-        max_wall_time_ms: number;
-        max_cost_usd: number;
-    };
-    scopes: string[];
-    action_allowlist: string[];
-}
-/** Type guard: is this bridge frame a fully-formed workflow_gate frame? */
-export declare function isWorkflowGateFrame(frame: BridgeFrame): frame is BridgeFrame<WorkflowGate>;
-/** A callback that produces an answer for a received gate (the agent's "memory"). */
-export type WorkflowGateResolver = (gate: WorkflowGate) => unknown | Promise<unknown>;