@vibesdotdev/agent-execution 0.0.0-stage → 1.0.0-rc.2

package/dist/code-session/interfaces/code-session.d.ts

@@ -0,0 +1,448 @@
+/**
+ * Code Session interface — the contract every `agent/code-session` impl
+ * (consumer Bun-on-a-Host, cloud Cloudflare Sandbox) satisfies.
+ *
+ * Node-free / Playwright-free at the type level so the cloud adapter can import
+ * it without dragging a Node-only impl into a workerd bundle. Git op shapes
+ * follow the `git/operations` contract in `@vibesdotdev/git-operations` so
+ * consumer + cloud agree on result shapes.
+ */
+import * as z from 'zod/v4';
+import { type AgentCodeSessionDescriptor } from '../agent-code-session.descriptor.ts';
+/**
+ * A transient clone/push credential. Injected via a git credential helper in the
+ * process env for the single clone invocation — NEVER embedded in the clone URL
+ * (which would persist into `.git/config`) and never logged. Resolved by the
+ * caller from the repo's `credentialId` (provider `resolveCloneCredential`).
+ */
+export declare const CodeSessionCloneCredentialSchema: z.ZodObject<{
+    username: z.ZodOptional<z.ZodString>;
+    token: z.ZodString;
+    kind: z.ZodOptional<z.ZodLiteral<"token">>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    remoteUrl: z.ZodOptional<z.ZodString>;
+    operations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        push: "push";
+        clone: "clone";
+        fetch: "fetch";
+        pull: "pull";
+    }>>>;
+    expiresAtEpochMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type CodeSessionCloneCredential = z.infer<typeof CodeSessionCloneCredentialSchema>;
+export declare const CodeSessionInitializeInputSchema: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+    workspacePath: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodString>;
+    cloneCredential: z.ZodOptional<z.ZodObject<{
+        username: z.ZodOptional<z.ZodString>;
+        token: z.ZodString;
+        kind: z.ZodOptional<z.ZodLiteral<"token">>;
+        repositoryId: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        operations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            push: "push";
+            clone: "clone";
+            fetch: "fetch";
+            pull: "pull";
+        }>>>;
+        expiresAtEpochMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    checkoutRef: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"provisioned">;
+        adapter: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        ttlHours: z.ZodOptional<z.ZodNumber>;
+        providerConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>], "kind">>;
+    initialEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    exposedPorts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    onAllocated: z.ZodOptional<z.ZodCustom<(sessionId: string) => void | Promise<void>, (sessionId: string) => void | Promise<void>>>;
+    runtimeConfig: z.ZodOptional<z.ZodObject<{
+        environmentName: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        bun: z.ZodOptional<z.ZodString>;
+        setupScript: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type CodeSessionInitializeInput = z.infer<typeof CodeSessionInitializeInputSchema>;
+export declare const CodeSessionCreateOrGetInputSchema: z.ZodObject<{
+    workspacePath: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodString>;
+    cloneCredential: z.ZodOptional<z.ZodObject<{
+        username: z.ZodOptional<z.ZodString>;
+        token: z.ZodString;
+        kind: z.ZodOptional<z.ZodLiteral<"token">>;
+        repositoryId: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        operations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            push: "push";
+            clone: "clone";
+            fetch: "fetch";
+            pull: "pull";
+        }>>>;
+        expiresAtEpochMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    checkoutRef: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"provisioned">;
+        adapter: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        ttlHours: z.ZodOptional<z.ZodNumber>;
+        providerConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>], "kind">>;
+    initialEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    exposedPorts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    onAllocated: z.ZodOptional<z.ZodCustom<(sessionId: string) => void | Promise<void>, (sessionId: string) => void | Promise<void>>>;
+    runtimeConfig: z.ZodOptional<z.ZodObject<{
+        environmentName: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        bun: z.ZodOptional<z.ZodString>;
+        setupScript: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    operationId: z.ZodString;
+}, z.core.$strict>;
+export type CodeSessionCreateOrGetInput = z.infer<typeof CodeSessionCreateOrGetInputSchema>;
+export declare function parseCodeSessionInitializeInput<TInput>(value: TInput): CodeSessionInitializeInput;
+export declare function parseCodeSessionCreateOrGetInput<TInput>(value: TInput): CodeSessionCreateOrGetInput;
+export { CodeSessionOperationStageSchema, CodeSessionOperationCleanupSchema, PersistedCodeSessionOperationSchema, type CodeSessionOperationStage, type PersistedCodeSessionOperation } from '../../schemas/session-operation.ts';
+export declare const CodeSessionHandleSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    operationId: z.ZodOptional<z.ZodString>;
+    workspacePath: z.ZodString;
+    workspaceOwnership: z.ZodOptional<z.ZodEnum<{
+        owned: "owned";
+        borrowed: "borrowed";
+    }>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    previewUrl: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"provisioned">;
+        adapter: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        ttlHours: z.ZodOptional<z.ZodNumber>;
+        providerConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>], "kind">;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type CodeSessionHandle = z.infer<typeof CodeSessionHandleSchema>;
+export declare const RunCommandInputSchema: z.ZodObject<{
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    background: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+}, z.core.$strict>;
+export type RunCommandInput = z.infer<typeof RunCommandInputSchema>;
+export declare const RunCommandResultSchema: z.ZodObject<{
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    timedOut: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+    procId: z.ZodOptional<z.ZodString>;
+    running: z.ZodOptional<z.ZodBoolean>;
+    aborted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type RunCommandResult = z.infer<typeof RunCommandResultSchema>;
+export declare const PatchFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    diff: z.ZodString;
+}, z.core.$strict>;
+export type PatchFileInput = z.infer<typeof PatchFileInputSchema>;
+export declare const GitApplyInputSchema: z.ZodObject<{
+    diff: z.ZodString;
+    check: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type GitApplyInput = z.infer<typeof GitApplyInputSchema>;
+export declare const GitApplyResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export type GitApplyResult = z.infer<typeof GitApplyResultSchema>;
+export declare const GitStatusResultSchema: z.ZodObject<{
+    staged: z.ZodArray<z.ZodString>;
+    unstaged: z.ZodArray<z.ZodString>;
+    untracked: z.ZodArray<z.ZodString>;
+    branch: z.ZodString;
+}, z.core.$strict>;
+export type GitStatusResult = z.infer<typeof GitStatusResultSchema>;
+export declare const GitCommitInputSchema: z.ZodObject<{
+    message: z.ZodString;
+    author: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type GitCommitInput = z.infer<typeof GitCommitInputSchema>;
+/** Native foreground lifetime, kept separate from the serializable Git input. */
+export declare const GitCommitOptionsSchema: z.ZodObject<{
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+}, z.core.$strict>;
+export type GitCommitOptions = z.infer<typeof GitCommitOptionsSchema>;
+export declare const GitCommitResultSchema: z.ZodObject<{
+    hash: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type GitCommitResult = z.infer<typeof GitCommitResultSchema>;
+export declare const GitPushInputSchema: z.ZodObject<{
+    remote: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    setUpstream: z.ZodOptional<z.ZodBoolean>;
+    credential: z.ZodOptional<z.ZodObject<{
+        username: z.ZodOptional<z.ZodString>;
+        token: z.ZodString;
+        kind: z.ZodOptional<z.ZodLiteral<"token">>;
+        repositoryId: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        operations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            push: "push";
+            clone: "clone";
+            fetch: "fetch";
+            pull: "pull";
+        }>>>;
+        expiresAtEpochMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type GitPushInput = z.infer<typeof GitPushInputSchema>;
+/**
+ * Resolve a transient push credential for a session's repository. Supplied by the
+ * HOST (which owns the cross-app auth context to call the platform
+ * `clone-url`/`clone-credential` endpoint) and invoked by `gitPush` when no
+ * explicit `credential` is passed. Returns `null` for public/no-auth repos.
+ */
+export type PushCredentialResolver = (repositoryId: string) => Promise<CodeSessionCloneCredential | null>;
+export declare function parsePushCredentialResolver<TInput>(value: TInput): PushCredentialResolver;
+export declare const ExposePortInputSchema: z.ZodObject<{
+    port: z.ZodString;
+}, z.core.$strict>;
+export type ExposePortInput = z.infer<typeof ExposePortInputSchema>;
+export declare const ExposePortResultSchema: z.ZodObject<{
+    port: z.ZodString;
+    previewUrl: z.ZodString;
+}, z.core.$strict>;
+export type ExposePortResult = z.infer<typeof ExposePortResultSchema>;
+export declare const BackgroundProcessInfoSchema: z.ZodObject<{
+    procId: z.ZodString;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    running: z.ZodNullable<z.ZodBoolean>;
+    startedAt: z.ZodString;
+    pid: z.ZodOptional<z.ZodNumber>;
+    exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type BackgroundProcessInfo = z.infer<typeof BackgroundProcessInfoSchema>;
+/** Where a background process's output is read from: output after `since`, a cursor from an earlier read. */
+export declare const BackgroundProcessReadInputSchema: z.ZodObject<{
+    since: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type BackgroundProcessReadInput = z.infer<typeof BackgroundProcessReadInputSchema>;
+/** A bounded wait for a background process's exit; the deadline never stops the process. */
+export declare const BackgroundProcessWaitInputSchema: z.ZodObject<{
+    since: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodNumber;
+}, z.core.$strict>;
+export type BackgroundProcessWaitInput = z.infer<typeof BackgroundProcessWaitInputSchema>;
+/**
+ * A background process's output since a cursor and its state. `cursor` is the
+ * monotonic count of output chunks it has produced: pass it as the next `since`
+ * to read only newer output. `timedOut` is true only for a wait whose deadline
+ * passed before the process ended.
+ */
+export declare const BackgroundProcessOutputSchema: z.ZodObject<{
+    procId: z.ZodString;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    cursor: z.ZodNumber;
+    running: z.ZodNullable<z.ZodBoolean>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    timedOut: z.ZodBoolean;
+}, z.core.$strict>;
+export type BackgroundProcessOutput = z.infer<typeof BackgroundProcessOutputSchema>;
+export declare function parseCodeSessionId<TInput>(value: TInput): string;
+export declare function parseCodeSessionPath<TInput>(value: TInput, field?: string): string;
+export declare function parseCodeSessionText<TInput>(value: TInput, field: string): string;
+export declare function parseRunCommandInput<TInput>(value: TInput): RunCommandInput;
+export declare function parsePatchFileInput<TInput>(value: TInput): PatchFileInput;
+export declare function parseGitApplyInput<TInput>(value: TInput): GitApplyInput;
+export declare function parseGitCommitInput<TInput>(value: TInput): GitCommitInput;
+export declare function parseGitCommitOptions<TInput>(value: TInput): GitCommitOptions;
+export declare function parseGitPushInput<TInput>(value: TInput): GitPushInput;
+export declare function parseExposePortInput<TInput>(value: TInput): ExposePortInput;
+export declare function parseProcessId<TInput>(value: TInput): string;
+export declare function parseBackgroundProcessReadInput<TInput>(value: TInput): BackgroundProcessReadInput;
+export declare function parseBackgroundProcessWaitInput<TInput>(value: TInput): BackgroundProcessWaitInput;
+export declare function parseProcessSignal<TInput>(value: TInput): string | undefined;
+export declare function parseWriteFileInput<TPath, TContent>(path: TPath, content: TContent): {
+    path: string;
+    content: string;
+};
+export interface CodeSessionInterface {
+    readonly descriptor: AgentCodeSessionDescriptor;
+    /**
+     * Compatibility create surface. Implementations mint a fresh operation id
+     * when one is absent, then delegate to `createOrGet`.
+     */
+    initialize(input: CodeSessionInitializeInput): Promise<CodeSessionHandle>;
+    /**
+     * Durably create or recover exactly one execution environment for a caller
+     * operation. This is the canonical API for retryable/headless dispatch.
+     */
+    createOrGet(input: CodeSessionCreateOrGetInput): Promise<CodeSessionHandle>;
+    /** Resume a previously-initialized session by id (throws if unknown). */
+    attach(sessionId: string): Promise<CodeSessionHandle>;
+    /** Discover sessions persisted by this implementation on the current execution target. */
+    discover?(): Promise<CodeSessionHandle[]>;
+    /** Run a command in the session workspace (foreground or background). */
+    runCommand(sessionId: string, input: RunCommandInput): Promise<RunCommandResult>;
+    /** List background processes spawned in this session (running + retained exited). */
+    listBackgroundProcesses(sessionId: string): Promise<BackgroundProcessInfo[]>;
+    /**
+     * Stop one background process (SIGTERM by default, override via `signal`).
+     * Idempotent: true when the procId is known, false only when unknown.
+     */
+    stopBackgroundProcess(sessionId: string, procId: string, signal?: string): Promise<boolean>;
+    /**
+     * Output one background process produced since `since`, and its state. Optional:
+     * a host that does not keep background output refuses at the caller
+     * (`UNAVAILABLE`); an unknown procId refuses `NOT_FOUND`.
+     */
+    readBackgroundProcess?(sessionId: string, procId: string, input?: BackgroundProcessReadInput): Promise<BackgroundProcessOutput>;
+    /**
+     * Wait up to `timeoutMs` for one background process to end, then its output
+     * since `since`. The deadline never stops the process (`timedOut: true`).
+     */
+    waitBackgroundProcess?(sessionId: string, procId: string, input: BackgroundProcessWaitInput): Promise<BackgroundProcessOutput>;
+    /** Read a file from the workspace (utf8). */
+    readFile(sessionId: string, path: string): Promise<string>;
+    /** Write a file in the workspace (utf8, creates parent dirs). */
+    writeFile(sessionId: string, path: string, content: string): Promise<void>;
+    /** Apply a unified diff to a file in the workspace. */
+    patchFile(sessionId: string, input: PatchFileInput): Promise<void>;
+    /** Apply a unified diff via `git apply` (optionally `--check` only). */
+    gitApply(sessionId: string, input: GitApplyInput): Promise<GitApplyResult>;
+    /** Git status of the workspace. */
+    gitStatus(sessionId: string): Promise<GitStatusResult>;
+    /** Stage + commit changes. */
+    gitCommit(sessionId: string, input: GitCommitInput, options?: GitCommitOptions): Promise<GitCommitResult>;
+    /** Push commits to a remote (caller gates with a confirmation). */
+    gitPush(sessionId: string, input?: GitPushInput): Promise<void>;
+    /**
+     * Register a host-supplied resolver that `gitPush` calls (with the session's
+     * `repositoryId`) to obtain a push credential when none is passed explicitly.
+     * Optional: a host that always passes `gitPush({ credential })` need not set it.
+     */
+    setPushCredentialResolver?(resolver: PushCredentialResolver): void;
+    /** Expose a port and return a preview URL. */
+    exposePort(sessionId: string, input: ExposePortInput): Promise<ExposePortResult>;
+    /**
+     * Pause the session: stop its background processes, keep the workspace, and
+     * refuse `runCommand` (`code-session-paused`) until resumed. Idempotent.
+     */
+    pause?(sessionId: string): Promise<CodeSessionHandle>;
+    /** Resume a paused session and re-attach it. Idempotent on a running session. */
+    resume?(sessionId: string): Promise<CodeSessionHandle>;
+    /** Tear down the session: kill procs, remove the persistent workspace. */
+    teardown(sessionId: string): Promise<void>;
+}
+/** Fields that define one code-session allocation, excluding credentials and callbacks. */
+export declare const CodeSessionOperationConfigurationSchema: z.ZodObject<{
+    authorityId: z.ZodOptional<z.ZodString>;
+    workspacePath: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodString>;
+    checkoutRef: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"provisioned">;
+        adapter: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        ttlHours: z.ZodOptional<z.ZodNumber>;
+        providerConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>], "kind">>;
+    initialEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    exposedPorts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeConfig: z.ZodOptional<z.ZodObject<{
+        environmentName: z.ZodOptional<z.ZodString>;
+        node: z.ZodOptional<z.ZodString>;
+        bun: z.ZodOptional<z.ZodString>;
+        setupScript: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    cloneCredentialBinding: z.ZodOptional<z.ZodObject<{
+        username: z.ZodOptional<z.ZodString>;
+        repositoryId: z.ZodOptional<z.ZodString>;
+        remoteUrl: z.ZodOptional<z.ZodString>;
+        operations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            push: "push";
+            clone: "clone";
+            fetch: "fetch";
+            pull: "pull";
+        }>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CodeSessionOperationConfiguration = z.infer<typeof CodeSessionOperationConfigurationSchema>;
+/**
+ * Hash the immutable, non-secret allocation configuration shared by consumer,
+ * relay, and cloud implementations. Clone credentials and callbacks are
+ * intentionally absent so a retry can carry a refreshed credential without
+ * becoming a different operation.
+ */
+export declare function codeSessionOperationFingerprint(input: CodeSessionInitializeInput, options?: {
+    authorityId?: string;
+}): Promise<string>;
+/** Stable filesystem/provider key for an operation id without exposing it in a path. */
+export declare const CodeSessionOperationIdSchema: z.ZodString;
+export declare function codeSessionOperationKey(operationId: string): Promise<string>;
+/**
+ * The name of a code-session child's TMPDIR under its host's temp root: a
+ * prefix of the workspace key. Tools bind Unix sockets under TMPDIR, and a
+ * socket path holds at most 104 bytes on macOS (108 on Linux), so the
+ * directory stays short; HOME keeps the full key in the profile root.
+ */
+export declare function codeSessionTempName(key: string): string;
+//# sourceMappingURL=code-session.d.ts.map

package/dist/code-session/interfaces/code-session.d.ts.map

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