@xenosystem/agent-interface-electron-host 0.1.3

package/dist/sdkAgent.d.ts

@@ -0,0 +1,232 @@
+/**
+ * SDK Agent Bridge
+ *
+ * Wraps the xeno-agent-sdk's AgentLoop for use in the Hub's main process.
+ * Replaces the custom agentLoop.ts + hubTools.ts with the SDK's production-grade
+ * agentic loop, tool registry, and permission engine.
+ *
+ * Hub-specific tools (web_search, open_app) are registered alongside the SDK's
+ * built-in tools (Read, Write, Edit, Glob, Grep, Bash).
+ */
+import { type PermissionWaitListener } from '@xenosystem/agent-interface-host';
+export type { SdkAgentSurface } from './sdkAgentSurface.js';
+import type { SdkAgentSurface } from './sdkAgentSurface.js';
+import { type AgentPermissionProfileName, type AgentSandboxCapabilities, type RuntimeEventEnvelope, type RuntimeEventStore } from '@xenosystem/agent-interface-host/node';
+interface ToolDefinitionLocal {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+interface ToolResultLocal {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export declare function onPermissionWaitChange(listener: PermissionWaitListener): () => void;
+type SurfaceApprovalAction = 'TerminalWriteInput' | 'BrowserGoto' | 'BrowserClick' | 'BrowserType' | 'BrowserKey';
+export interface SurfaceApprovalRule {
+    id?: string;
+    surface: 'terminal' | 'browser';
+    action: SurfaceApprovalAction;
+    matcher: string;
+    command?: string;
+    browserOrigin?: string;
+    urlPattern?: string;
+    selector?: string;
+    key?: string;
+    label?: string;
+    createdAt?: number;
+}
+export declare function logAgentDebug(message: string, meta?: Record<string, unknown>): void;
+export type { AgentPermissionProfileName, AgentSandboxCapabilities, } from '@xenosystem/agent-interface-host/node';
+export interface SdkAgentRunOptions {
+    requestId: string;
+    conversationId?: string;
+    sdkSessionId?: string;
+    subagentRunId?: string;
+    workspaceId?: string;
+    teamId?: string;
+    agentId?: string;
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    systemPrompt?: string;
+    maxIterations?: number;
+    enableThinking?: boolean;
+    getAuthToken: () => string | null;
+    getPlatformAuthToken?: () => string | null;
+    mainWindow: SdkAgentSurface;
+    signal: AbortSignal;
+    capabilities?: AgentSandboxCapabilities;
+    permissionProfile?: AgentPermissionProfileName;
+    allowedDirectories?: string[];
+    approvalRules?: Array<Record<string, unknown>> | SurfaceApprovalRule[];
+    /** Chat-only compatibility escape hatch. Engineering host adapters always set this false. */
+    allowTextOnlyFallback?: boolean;
+    /** When `'disabled'`, every tool is unregistered before the model is asked anything. */
+    toolExecution?: 'enabled' | 'disabled';
+    /** Receives the exact envelope after the host-owned runtime store commits it. */
+    onPersistedRuntimeEvent?: (event: RuntimeEventEnvelope) => void;
+    /** Host-owned journal used for this surface; defaults to the legacy per-user store for compatibility. */
+    runtimeEventStore?: RuntimeEventStore;
+    /**
+     * Coordination tools — ADE §5.2b — already built and already RUN-SCOPED.
+     *
+     * 🔴 Arrives finished. The host binds the caller's run id before these ever
+     * reach this process, so nothing here can address a coordination call as
+     * another run — there is no parameter through which to try. Absent means the
+     * host has no coordination mounted, and the agent correctly sees no such
+     * tools rather than tools that answer "unavailable".
+     */
+    coordinationTools?: Array<{
+        definition: ToolDefinitionLocal;
+        execute: (input: Record<string, unknown>) => Promise<ToolResultLocal>;
+    }>;
+    /**
+     * Whether this process is a production build.
+     *
+     * Supplied by the composition because the answer is a fact about the HOST, not about the loop:
+     * Electron knows it as `app.isPackaged`, and a headless host has no such notion. Absent
+     * resolves to `true` — see the note at the use site; the permissive value is the one that
+     * unlocks `debug-bypass`, so it must never be reached by default.
+     */
+    isProduction?: boolean;
+}
+export declare function runSdkAgent(options: SdkAgentRunOptions): Promise<void>;
+export declare function grantSdkAccess(params: unknown): {
+    success: boolean;
+    error?: string;
+};
+export declare function denySdkAccess(params: unknown): {
+    success: boolean;
+    error?: string;
+};
+export declare function answerSdkAskUser(params: unknown): {
+    success: boolean;
+    error?: string;
+};
+export declare function createSdkNativeInteractionService(): {
+    answerPermission(params: {
+        permissionId: string;
+        granted: boolean;
+        directory?: string;
+    }): {
+        success: boolean;
+        error?: string;
+    };
+    answerAskUser(params: {
+        askUserId: string;
+        answer: string;
+        selectedOption?: string;
+        cancelled?: boolean;
+    }): {
+        success: boolean;
+        error?: string;
+    };
+};
+export interface SdkNativeControlService {
+    listSessions(params?: {
+        role?: string;
+        workingDirectory?: string;
+        limit?: number;
+    }): Promise<{
+        success: boolean;
+        sessions?: unknown[];
+        error?: string;
+    }>;
+    showSession(params: {
+        sessionId: string;
+    }): Promise<{
+        success: boolean;
+        session?: unknown;
+        sessionDir?: string;
+        checkpoints?: unknown[];
+        error?: string;
+    }>;
+    attachSession(params: {
+        conversationId: string;
+        sessionId: string;
+    }): Promise<{
+        success: boolean;
+        session?: unknown;
+        sessionDir?: string;
+        sessionHistoryPath?: string;
+        checkpoints?: unknown[];
+        error?: string;
+    }>;
+    detachSession(params: {
+        conversationId: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    deleteSession(params: {
+        sessionId: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    cleanSessions(params: {
+        workingDirectory: string;
+        excludeSessionIds?: string[];
+    }): Promise<{
+        success: boolean;
+        result?: unknown;
+        error?: string;
+    }>;
+    listCheckpoints(params: {
+        sessionId: string;
+    }): Promise<{
+        success: boolean;
+        checkpoints?: unknown[];
+        error?: string;
+    }>;
+    restoreCheckpoint(params: {
+        sessionId: string;
+        checkpointId: string;
+        conversationId?: string;
+    }): Promise<{
+        success: boolean;
+        restored?: unknown;
+        pendingRuntimeRestore?: boolean;
+        error?: string;
+    }>;
+    deleteCheckpoint(params: {
+        sessionId: string;
+        checkpointId: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    readTaskOutput(params: {
+        taskId: string;
+        offset?: number;
+    }): Promise<{
+        success: boolean;
+        output?: string;
+        error?: string;
+        command?: string;
+        status?: 'running' | 'completed' | 'failed' | 'stopped' | 'unknown';
+        exitCode?: number | null;
+        totalSize?: number;
+    }>;
+    stopTask(params: {
+        taskId: string;
+    }): Promise<{
+        success: boolean;
+        output?: string;
+        error?: string;
+        command?: string;
+        status?: 'running' | 'completed' | 'failed' | 'stopped' | 'unknown';
+        exitCode?: number | null;
+        totalSize?: number;
+    }>;
+}
+export declare function createSdkNativeControlService(): SdkNativeControlService;
+//# sourceMappingURL=sdkAgent.d.ts.map

package/dist/sdkAgent.d.ts.map

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