pikiloom 0.4.36 → 0.4.38

package/packages/kernel/dist/contracts/driver.d.ts

@@ -0,0 +1,95 @@
+import type { UniversalToolCall, UniversalPlan, UniversalUsage, UniversalInteraction, UniversalArtifact, UniversalSubAgent } from '../protocol/index.js';
+export interface AgentTurnInput {
+    prompt: string;
+    attachments?: string[];
+    sessionId?: string | null;
+    workdir: string;
+    model?: string | null;
+    effort?: string | null;
+    systemPrompt?: string;
+    env?: Record<string, string>;
+    extraMcpServers?: McpServerSpec[];
+    mcpConfigPath?: string | null;
+    permissionMode?: string | null;
+    extraArgs?: string[];
+    configOverrides?: string[];
+    fullAccess?: boolean;
+    steerable?: boolean;
+}
+export interface McpServerSpec {
+    name: string;
+    type?: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+export type DriverEvent = {
+    type: 'session';
+    sessionId: string;
+} | {
+    type: 'text';
+    delta: string;
+} | {
+    type: 'reasoning';
+    delta: string;
+} | {
+    type: 'tool';
+    call: UniversalToolCall;
+} | {
+    type: 'plan';
+    plan: UniversalPlan;
+} | {
+    type: 'subagent';
+    subagent: UniversalSubAgent;
+} | {
+    type: 'usage';
+    usage: Partial<UniversalUsage>;
+} | {
+    type: 'artifact';
+    artifact: UniversalArtifact;
+} | {
+    type: 'activity';
+    line: string;
+};
+export type SteerFn = (prompt: string, attachments?: string[]) => Promise<boolean>;
+export interface DriverContext {
+    signal: AbortSignal;
+    emit(event: DriverEvent): void;
+    askUser(interaction: UniversalInteraction): Promise<Record<string, string[]>>;
+    registerSteer(fn: SteerFn): void;
+}
+export interface DriverResult {
+    ok: boolean;
+    text: string;
+    reasoning?: string;
+    error?: string | null;
+    stopReason?: string | null;
+    sessionId?: string | null;
+    usage?: UniversalUsage | null;
+}
+export interface TuiInput {
+    workdir: string;
+    model?: string | null;
+    sessionId?: string | null;
+    env?: Record<string, string>;
+    extraArgs?: string[];
+}
+export interface TuiSpec {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface AgentDriver {
+    readonly id: string;
+    readonly capabilities?: {
+        steer?: boolean;
+        interact?: boolean;
+        resume?: boolean;
+        tui?: boolean;
+    };
+    run(input: AgentTurnInput, ctx: DriverContext): Promise<DriverResult>;
+    tui?(input: TuiInput): TuiSpec;
+}

package/packages/kernel/dist/contracts/driver.js

@@ -0,0 +1 @@
+export {};

package/packages/kernel/dist/contracts/ports.d.ts

@@ -0,0 +1,84 @@
+import type { UniversalInteraction, UniversalSnapshot, ModelDescriptor, EffortOption, ToolDescriptor, SkillDescriptor } from '../protocol/index.js';
+import type { McpServerSpec, DriverResult } from './driver.js';
+export interface CoreSessionRecord {
+    agent: string;
+    sessionId: string;
+    nativeSessionId?: string | null;
+    workspacePath: string;
+    createdAt: string;
+    updatedAt: string;
+    title?: string | null;
+    model?: string | null;
+    effort?: string | null;
+    runState?: 'running' | 'completed' | 'incomplete';
+    runDetail?: string | null;
+}
+export interface SessionStore {
+    ensure(agent: string, opts: {
+        sessionId?: string | null;
+        title?: string | null;
+        workdir: string;
+    }): Promise<{
+        sessionId: string;
+        workspacePath: string;
+    }>;
+    get(agent: string, sessionId: string): Promise<CoreSessionRecord | null>;
+    save(record: CoreSessionRecord): Promise<void>;
+    list(agent: string, opts?: {
+        limit?: number;
+    }): Promise<CoreSessionRecord[]>;
+    recordResult(agent: string, sessionId: string, result: DriverResult): Promise<void>;
+    appendTurn?(agent: string, sessionId: string, turn: UniversalSnapshot): Promise<void>;
+    history?(agent: string, sessionId: string): Promise<UniversalSnapshot[]>;
+}
+export interface ModelInjection {
+    model?: string | null;
+    env?: Record<string, string>;
+    extraArgs?: string[];
+    configOverrides?: string[];
+    providerName?: string | null;
+    contextWindow?: number | null;
+}
+export interface ModelResolver {
+    resolve(agent: string, opts: {
+        model?: string | null;
+        profileId?: string | null;
+    }): Promise<ModelInjection | null>;
+}
+export interface ToolProvider {
+    provideForSession(opts: {
+        agent: string;
+        workdir: string;
+        workspacePath: string;
+    }): Promise<{
+        servers: McpServerSpec[];
+        env?: Record<string, string>;
+    }>;
+}
+export interface SystemPromptBuilder {
+    compose(opts: {
+        agent: string;
+        base?: string;
+        isFirstTurn: boolean;
+    }): string | undefined;
+}
+export interface InteractionHandler {
+    askUser(interaction: UniversalInteraction): Promise<Record<string, string[]> | null>;
+}
+export interface Catalog {
+    listModels(opts: {
+        agent: string;
+    }): Promise<ModelDescriptor[]>;
+    listEffort(opts: {
+        agent: string;
+        model?: string | null;
+    }): Promise<EffortOption[]>;
+    listTools(opts: {
+        agent: string;
+        workdir: string;
+    }): Promise<ToolDescriptor[]>;
+    listSkills(opts: {
+        agent: string;
+        workdir: string;
+    }): Promise<SkillDescriptor[]>;
+}

package/packages/kernel/dist/contracts/ports.js

@@ -0,0 +1 @@
+export {};

package/packages/kernel/dist/contracts/surface.d.ts

@@ -0,0 +1,75 @@
+import type { UniversalSnapshot, SnapshotPatch, SessionMeta, AgentInfo, ModelDescriptor, EffortOption, ToolDescriptor, SkillDescriptor } from '../protocol/index.js';
+import type { McpServerSpec } from './driver.js';
+export interface PromptInput {
+    prompt: string;
+    agent?: string;
+    sessionKey?: string;
+    workdir?: string;
+    model?: string | null;
+    effort?: string | null;
+    attachments?: string[];
+}
+export interface LoomIO {
+    prompt(input: PromptInput): Promise<{
+        sessionKey: string;
+        taskId: string;
+    }>;
+    stop(sessionKey: string): boolean;
+    steer(taskId: string, prompt: string, attachments?: string[]): Promise<boolean>;
+    interact(promptId: string, action: 'select' | 'text' | 'skip' | 'cancel', value?: string): boolean;
+    subscribe(cb: (sessionKey: string, snapshot: UniversalSnapshot, patch: SnapshotPatch, seq: number) => void): () => void;
+    onSessionsChanged(cb: (sessions: SessionMeta[]) => void): () => void;
+    listSessions(): SessionMeta[];
+    getSnapshot(sessionKey: string): {
+        snapshot: UniversalSnapshot;
+        seq: number;
+    } | null;
+    getHistory(sessionKey: string): Promise<UniversalSnapshot[]>;
+    listAgents(): string[];
+    listAgentInfo(): AgentInfo[];
+    listModels(agent: string): Promise<ModelDescriptor[]>;
+    listEffort(agent: string, model?: string | null): Promise<EffortOption[]>;
+    listTools(agent: string, workdir?: string): Promise<ToolDescriptor[]>;
+    listSkills(agent: string, workdir?: string): Promise<SkillDescriptor[]>;
+}
+export interface SurfaceCapabilities {
+    editMessages?: boolean;
+    images?: boolean;
+    buttons?: boolean;
+    tunnel?: boolean;
+}
+export interface PtyHandle {
+    onData(cb: (data: string) => void): () => void;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(signal?: string): void;
+    onExit(cb: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): () => void;
+    readonly pid: number;
+}
+export interface TuiHost {
+    openTui(opts: {
+        agent?: string;
+        workdir?: string;
+        model?: string | null;
+        sessionId?: string | null;
+        cols?: number;
+        rows?: number;
+    }): Promise<PtyHandle>;
+}
+export interface Surface {
+    readonly id: string;
+    readonly capabilities?: SurfaceCapabilities;
+    start(io: LoomIO, host?: TuiHost): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface Plugin {
+    readonly id: string;
+    tools?(opts: {
+        agent: string;
+        workdir: string;
+    }): McpServerSpec[] | Promise<McpServerSpec[]>;
+    decorateSnapshot?(snapshot: UniversalSnapshot): UniversalSnapshot;
+}

package/packages/kernel/dist/contracts/surface.js

@@ -0,0 +1 @@
+export {};

package/packages/kernel/dist/drivers/claude.d.ts

@@ -0,0 +1,23 @@
+import type { AgentDriver, AgentTurnInput, DriverContext, DriverResult, DriverEvent, TuiInput, TuiSpec } from '../contracts/driver.js';
+import type { UniversalPlan } from '../protocol/index.js';
+export declare class ClaudeDriver implements AgentDriver {
+    private readonly bin;
+    readonly id = "claude";
+    readonly capabilities: {
+        steer: boolean;
+        interact: boolean;
+        resume: boolean;
+        tui: boolean;
+    };
+    constructor(bin?: string);
+    tui(input: TuiInput): TuiSpec;
+    run(input: AgentTurnInput, ctx: DriverContext): Promise<DriverResult>;
+    private usage;
+}
+export declare function handleClaudeEvent(ev: any, s: any, emit: (e: DriverEvent) => void): void;
+export declare function claudeUserMessage(text: string): string;
+export declare function emitClaudeImages(blocks: any[], s: any, emit: (e: DriverEvent) => void): void;
+export declare function todoWriteToPlan(input: any): UniversalPlan | null;
+export declare function shortToolValue(value: unknown, max?: number): string;
+export declare function summarizeToolUse(name: string, input: any): string;
+export declare function firstResultLine(content: any): string;