@ai-hero/sandcastle 0.6.5 → 0.7.0

package/dist/AgentProvider.d.ts

@@ -1,134 +0,0 @@
-import { type HostSessionLookup, type SessionStore } from "./SessionStore.js";
-import type { BindMountSandboxHandle } from "./SandboxProvider.js";
-export type ParsedStreamEvent = {
-    type: "text";
-    text: string;
-} | {
-    type: "result";
-    result: string;
-} | {
-    type: "tool_call";
-    name: string;
-    args: string;
-} | {
-    type: "session_id";
-    sessionId: string;
-} | {
-    type: "usage";
-    usage: IterationUsage;
-};
-/** Options passed to buildPrintCommand and buildInteractiveArgs. */
-export interface AgentCommandOptions {
-    readonly prompt: string;
-    readonly dangerouslySkipPermissions: boolean;
-    /** When set, the agent should resume the given session ID instead of starting fresh. */
-    readonly resumeSession?: string;
-}
-/** Return type of buildPrintCommand — command string plus optional stdin content.
- *  When `stdin` is set, the sandbox pipes it to the child process's stdin
- *  instead of inlining the prompt in argv, avoiding the Linux 128 KB per-arg limit. */
-export interface PrintCommand {
-    readonly command: string;
-    readonly stdin?: string;
-}
-/** Per-iteration token usage snapshot extracted from the agent session. */
-export interface IterationUsage {
-    readonly inputTokens: number;
-    readonly cacheCreationInputTokens: number;
-    readonly cacheReadInputTokens: number;
-    readonly outputTokens: number;
-}
-export interface AgentSessionStorage {
-    hostStore(cwd: string): SessionStore;
-    sandboxStore(cwd: string, handle: BindMountSandboxHandle): SessionStore;
-    transfer(from: SessionStore, to: SessionStore, id: string): Promise<void>;
-    /**
-     * Locate a session on the host by its unique id, independent of cwd encoding.
-     * Used by the no-sandbox resume precheck, where the agent runs on the host and
-     * writes the session in place under a cwd-derived directory Sandcastle cannot
-     * reliably reconstruct. Returns the located path (or `undefined`) plus the
-     * directory that was searched (for not-found errors).
-     */
-    findByIdOnHost(id: string): Promise<HostSessionLookup>;
-}
-export interface AgentProvider {
-    readonly name: string;
-    /** Environment variables injected by this agent provider. Merged at launch time with env resolver and sandbox provider env. */
-    readonly env: Record<string, string>;
-    /** When true, session capture is enabled for this provider. Default: true for Claude Code, false for others. */
-    readonly captureSessions: boolean;
-    /** Provider-owned storage and transfer behavior for resumable agent sessions. */
-    readonly sessionStorage?: AgentSessionStorage;
-    buildPrintCommand(options: AgentCommandOptions): PrintCommand;
-    buildInteractiveArgs?(options: AgentCommandOptions): string[];
-    parseStreamLine(line: string): ParsedStreamEvent[];
-    /** Parse token usage from the captured session JSONL content. Only implemented by Claude Code. */
-    parseSessionUsage?(content: string): IterationUsage | undefined;
-}
-export declare const DEFAULT_MODEL = "claude-opus-4-7";
-/** Options for the pi agent provider. */
-export interface PiOptions {
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-}
-export declare const pi: (model: string, options?: PiOptions | undefined) => AgentProvider;
-/** Options for the codex agent provider. */
-export interface CodexOptions {
-    readonly effort?: "low" | "medium" | "high" | "xhigh";
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-    /** When false, session capture is disabled. Default: true. */
-    readonly captureSessions?: boolean;
-    /** Override Codex session directories for tests or non-standard installs. */
-    readonly sessionStorage?: {
-        readonly hostSessionsDir?: string;
-        readonly sandboxSessionsDir?: string;
-    };
-}
-export declare const codex: (model: string, options?: CodexOptions | undefined) => AgentProvider & {
-    readonly sessionStorage: AgentSessionStorage;
-};
-/** Options for the cursor agent provider. */
-export interface CursorOptions {
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-}
-export declare const cursor: (model: string, options?: CursorOptions | undefined) => AgentProvider;
-/** Options for the opencode agent provider. */
-export interface OpenCodeOptions {
-    /** Provider-specific reasoning effort variant (e.g. "high", "max", "low", "minimal"). */
-    readonly variant?: string;
-    /**
-     * Named OpenCode agent/mode to run, mapped to OpenCode's own `--agent` flag
-     * (e.g. "build", "plan"). This is distinct from Sandcastle's `--agent`
-     * provider selector — it chooses an agent *inside* OpenCode.
-     */
-    readonly agent?: string;
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-}
-export declare const opencode: (model: string, options?: OpenCodeOptions | undefined) => AgentProvider;
-/** Options for the GitHub Copilot CLI agent provider. */
-export interface CopilotOptions {
-    /** Reasoning effort level. Maps to the CLI's --effort flag. */
-    readonly effort?: "low" | "medium" | "high";
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-}
-export declare const copilot: (model: string, options?: CopilotOptions | undefined) => AgentProvider;
-export interface ClaudeCodeOptions {
-    readonly effort?: "low" | "medium" | "high" | "xhigh" | "max";
-    /** Environment variables injected by this agent provider. */
-    readonly env?: Record<string, string>;
-    /** When false, session capture is disabled. Default: true. */
-    readonly captureSessions?: boolean;
-    /** Override Claude session directories for tests or non-standard installs. */
-    readonly sessionStorage?: {
-        readonly hostProjectsDir?: string;
-        readonly sandboxProjectsDir?: string;
-    };
-}
-export declare const claudeCode: (model: string, options?: ClaudeCodeOptions | undefined) => AgentProvider & {
-    readonly sessionStorage: AgentSessionStorage;
-};
-//# sourceMappingURL=AgentProvider.d.ts.map

package/dist/AgentProvider.d.ts.map

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