@yitom/agy-acp-map 0.1.3 → 0.1.6

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.ts';
+export * from './session-core.ts';

package/dist/core/session-core.d.ts

@@ -0,0 +1,69 @@
+import { type DiscoveryResult } from '../lib/agy-discovery.ts';
+import { SessionStore } from '../lib/session-store.ts';
+import { SessionHistoryStore } from '../lib/session-history.ts';
+import { type SdkSession, type ProtocolVersion } from './types.ts';
+export interface SessionCoreOptions {
+    sessionStore?: SessionStore | string;
+    historyStore?: SessionHistoryStore | string;
+}
+export declare class AgySessionCore {
+    readonly sessions: Map<string, SdkSession>;
+    readonly sessionStore: SessionStore;
+    readonly historyStore: SessionHistoryStore;
+    private catalogPromise;
+    constructor(options?: SessionCoreOptions);
+    getDiscovery(): Promise<DiscoveryResult>;
+    /** Warm-up toggle: AGY_ACP_WARMUP=0/false/no disables connect-time pre-spawn. */
+    warmupEnabled(): boolean;
+    /** Shared spawn-target builder so warm-up and promptTurn launch identical agy. */
+    buildSpawnTarget(session: SdkSession): {
+        bin: string;
+        args: string[];
+    };
+    /**
+     * Connect-time warm-up: pull agy up in the background right after
+     * session/new|resume so the first prompt reuses a writable process.
+     * Fire-and-forget — never blocks the new/resume response. First real
+     * prompt attaches via setCallbacks; close/delete/cancel still kill.
+     */
+    warmupSession(sessionId: string): void;
+    /** Kill every live child (bridge shutdown path). Clients should still close/delete per session. */
+    shutdown(): Promise<void>;
+    persistSession(session: SdkSession, opts?: {
+        throwOnError?: boolean;
+    }): void;
+    persistTurnHistory(sessionId: string, userText: string, assistantText: string, stopReason: string, eligible?: boolean): void;
+    replayHistory(sessionId: string, protocolVersion: ProtocolVersion, notifyClient: (update: any) => Promise<void> | void): Promise<void>;
+    sessionMeta(session: SdkSession): Record<string, unknown> | undefined;
+    applyCatalogDefaults(session: SdkSession, discovery: DiscoveryResult): void;
+    createSession(params: any, protocolVersion?: ProtocolVersion): Promise<{
+        session: SdkSession;
+        discovery: DiscoveryResult;
+        meta?: Record<string, unknown>;
+    }>;
+    resumeSession(params: any, protocolVersion?: ProtocolVersion, opts?: {
+        warmup?: boolean;
+    }): Promise<{
+        session: SdkSession;
+        discovery: DiscoveryResult;
+        meta?: Record<string, unknown>;
+    }>;
+    updateConfigOption(params: any, protocolVersion: ProtocolVersion | undefined, buildOptionsFn: (discovery: DiscoveryResult, session?: Pick<SdkSession, 'model' | 'agent'>) => any[]): Promise<{
+        session: SdkSession;
+        discovery: DiscoveryResult;
+        configOptions: any[];
+        meta?: Record<string, unknown>;
+    }>;
+    listSessions(params?: any): Promise<{
+        sessions: any[];
+        nextCursor?: string | null;
+    }>;
+    deleteSession(params: any): Promise<{}>;
+    closeSession(params: any): Promise<{}>;
+    cancelSession(params: any): void;
+    promptTurn(params: any, protocolVersion: ProtocolVersion | undefined, notifyClient: (update: any) => Promise<void>, opts?: {
+        isPreLocked?: boolean;
+    }): Promise<{
+        stopReason: string;
+    }>;
+}

package/dist/core/types.d.ts

@@ -0,0 +1,69 @@
+import type { AgyProcessManager } from '../lib/agy-process.ts';
+import type { MapperState } from '../lib/map-agy-to-acp.ts';
+import type { SoftDenyInfo } from '../lib/soft-deny.ts';
+export declare const AGENT_INFO: {
+    name: string;
+    title: string;
+    version: string;
+};
+export declare const BRIDGE_CAPABILITIES: {
+    prompt: boolean;
+    streaming: boolean;
+    tools: boolean;
+    resume: boolean;
+    permissionRoundTrip: boolean;
+    permissionMode: string;
+    safetyTiers: ("autonomous" | "autonomous-unsandboxed" | "safe")[];
+    nativeCancel: boolean;
+    cancelMode: string;
+    historyReplay: boolean;
+    dynamicConfig: string;
+    richContentInput: string;
+    richContentOutput: string;
+    clientFilesystem: boolean;
+    clientTerminal: boolean;
+};
+export type ProtocolVersion = 1 | 2;
+export interface CatalogChoice {
+    value: string;
+    name: string;
+    description?: string;
+}
+export declare function catalogChoices(items: unknown, currentValue?: string): CatalogChoice[];
+export interface SdkSession {
+    sessionId: string;
+    cwd: string;
+    additionalDirectories?: string[];
+    createdAt: string;
+    updatedAt: string;
+    title?: string;
+    proc: AgyProcessManager;
+    mapper: MapperState;
+    busy: boolean;
+    cancelled: boolean;
+    protocolVersion: ProtocolVersion;
+    stderrBuf: string;
+    softDenies: SoftDenyInfo[];
+    softDenyEmitted: boolean;
+    stagedFiles: string[];
+    conversationId?: string;
+    model?: string;
+    effort?: string;
+    mode?: string;
+    agent?: string;
+    sandbox?: boolean;
+    jsonSchema?: string;
+    safety?: 'safe' | 'autonomous' | 'autonomous-unsandboxed';
+    skipPermissions?: boolean;
+    disableSlashCommands?: boolean;
+    printTimeout?: string;
+    deleted?: boolean;
+}
+/**
+ * Sequential FIFO execution queue to eliminate notification ordering races.
+ */
+export declare class AsyncSerialQueue {
+    private tail;
+    enqueue(fn: () => Promise<void> | void): Promise<void>;
+    drain(): Promise<void>;
+}

package/dist/index.d.ts

@@ -1,8 +1,11 @@
 /**
- * agy-acp-map: Official ACP v1/v2 Bridge for Google Antigravity CLI (agy).
+ * agy-acp-map: Universal ACP v1/v2 Bridge for Google Antigravity CLI (agy).
  * Primary entry point for library consumption in Node, Bun, and Electron.
  */
-export { AgyAcpService, createAcpV1App, createAcpV2App, createDualAcpApp, AGENT_INFO, BRIDGE_CAPABILITIES, type SdkSession, } from './agent-sdk.ts';
+export { AgyAcpService, createAcpV1App, createAcpV2App, createDualAcpApp, AGENT_INFO, BRIDGE_CAPABILITIES, AgySessionCore, AgyAcpV1Service, AgyAcpV2Service, type SdkSession, } from './agent-sdk.ts';
+export * as core from './core/index.ts';
+export * as v1 from './v1/index.ts';
+export * as v2 from './v2/index.ts';
 export * from './lib/map-agy-to-acp.ts';
 export * from './lib/agy-process.ts';
 export * from './lib/agy-args.ts';
@@ -12,3 +15,6 @@ export * from './lib/rich-content.ts';
 export * from './lib/path-allowlist.ts';
 export * from './lib/agy-discovery.ts';
 export * from './lib/session-store.ts';
+export * from './lib/session-history.ts';
+export * from './lib/win32-console.ts';
+export * from './lib/debug-log.ts';