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

package/dist/code-session/agent-code-session.impl.consumer.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Consumer Agent Code Session — runtime-routed impl (WS3)
+ *
+ * A *persistent* code session: unlike the throwaway `agent/sandbox`, the
+ * workspace under the active Vibes profile SURVIVES across calls until
+ * an explicit `teardown`. Lifecycle:
+ *
+ *   initialize → clone repo (git CLI) into the persistent workspace, register
+ *               session metadata so `attach` can resume.
+ *   attach    → resume a known session (rehydrate from the metadata store).
+ *   runCommand→ foreground (capture stdout/stderr/exit) OR background (a
+ *               long-lived process handle kept in an in-process registry).
+ *   read/write/patch → file ops scoped under the workspace root.
+ *   gitStatus/Commit/Push → git CLI in the workspace.
+ *   exposePort → record a port + return a localhost preview URL.
+ *   teardown  → kill background procs, remove the persistent workspace.
+ *
+ * All file ops route through the `filesystem/adapter` kind and all command
+ * execution through the `runtime/execution` kind (consumer impls back both):
+ * one-shot git/foreground commands use `execute()`; a long-lived background
+ * process uses `spawn()` and keeps its `ProcessHandle` live in an in-process
+ * registry. Raw `node:fs` / `Bun.spawn` are NOT used here — the impl stays
+ * swappable.
+ *
+ * Env is composed through the handed runtime's `composeChildEnv`: only host essentials +
+ * the caller's explicit env are forwarded; nothing from the host's own environment leaks
+ * into session processes.
+ *
+ * MVP host routing: a `{ kind:'host', hostId }` target runs LOCALLY (on this
+ * consumer worker/daemon). Dispatching to a *specific remote* Host daemon by
+ * `hostId` is a documented follow-up — the `hostId` is recorded on the session
+ * handle so a future remote-dispatch layer can target it.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import { type AgentCodeSessionDescriptor } from './agent-code-session.descriptor.ts';
+import type { BackgroundProcessInfo, BackgroundProcessOutput, BackgroundProcessReadInput, BackgroundProcessWaitInput, CodeSessionCreateOrGetInput, CodeSessionHandle, CodeSessionInterface, CodeSessionInitializeInput, GitApplyInput, GitApplyResult, GitCommitInput, GitCommitOptions, GitCommitResult, GitPushInput, GitStatusResult, ExposePortInput, ExposePortResult, PatchFileInput, PushCredentialResolver, RunCommandInput, RunCommandResult } from './interfaces/code-session.ts';
+export declare class ConsumerCodeSession implements CodeSessionInterface {
+    readonly descriptor: AgentCodeSessionDescriptor;
+    /** In-process session registry, keyed by sessionId — backs `attach`. */
+    private readonly sessions;
+    /** Live background procs per session. */
+    private readonly background;
+    /** Host-supplied resolver for a push credential keyed by repositoryId. */
+    private pushCredentialResolver?;
+    /** In-flight attach-on-demand attempts, keyed by sessionId — collapses concurrent callers onto one attach. */
+    private readonly attachInFlight;
+    /** Cached remote execution handles per non-local hostId (fleet wire). */
+    private readonly remotes;
+    private readonly remoteActiveHomes;
+    /** Cached remote workspace filesystem adapters per non-local hostId (fleet wire). */
+    private readonly remoteFilesystems;
+    /**
+     * Same-process create retries collapse before they reach the durable operation
+     * ledger. Claims are registered synchronously, keyed by the trimmed operation
+     * id, so call order is claim order regardless of when hashing finishes.
+     */
+    private readonly operationInFlight;
+    /** Serializes git add/commit per git repository root so concurrent sessions never collide on .git/index.lock. */
+    private readonly gitCommitQueues;
+    private readonly runtime;
+    private readonly activeHome;
+    constructor(descriptor: AgentCodeSessionDescriptor, runtime: RuntimeRef);
+    /** This session's logger, on the runtime that owns it. */
+    private get log();
+    private now;
+    private nowIso;
+    /** Local control records stay under this runtime's active profile. */
+    private sessionRoot;
+    private targetSessionRoot;
+    /** The temp root of the host a session runs on, from that host's path roots. */
+    private targetTempRoot;
+    setPushCredentialResolver(resolver: PushCredentialResolver): void;
+    /** Workspace-local process state belongs to the control root, not source files.
+     * Keep a private home across reattachments without inheriting host credentials.
+     * TMPDIR lives under the host's temp root with a short name, so sockets bound
+     * under it fit the platform's socket path limit.
+     */
+    private processEnvironment;
+    private seedGitAuthorIdentity;
+    /**
+     * Resolve the `runtime/execution` impl for a session's host target.
+     *
+     * THE JOIN (D-THE-JOIN): a `{ kind:'host', hostId }` target with a NON-local
+     * hostId reaches THAT host's execution impl over the fleet wire via
+     * `getVibesRemoteFrom(runtime, hostId)` (the proven path — fleet-daemon
+     * `reach-over-daemon.test.ts`). Local + default targets keep resolving the
+     * in-process impl exactly as before. There is NO silent local fallback: an
+     * unreachable host throws a precise, actionable error.
+     */
+    private execution;
+    /**
+     * Reach a remote host's `runtime/execution` over the fleet `runtime/rpc`
+     * wire. A `RemoteRuntime` pins its socket, so one connection per hostId is
+     * cached and reused across a session's commands; a failed resolve is dropped
+     * from the cache so a later call can retry once the host is paired.
+     */
+    private remoteRuntime;
+    /**
+     * Spawn on the session's host. With `setup`, cancellation is checked after
+     * every pre-dispatch await: a cancelled setup returns `null` and dispatches
+     * nothing. A remote dispatch is owned by an acquisition retained in this
+     * runtime's custody (plugin `onDispose` drains it), so a late port is killed
+     * once and observed rather than abandoned.
+     */
+    private spawnOnHost;
+    private spawnBackground;
+    /**
+     * Reach a remote host's workspace `filesystem/adapter` over the fleet
+     * `runtime/rpc` wire (UNIT-B3 / D-DAEMON-CLIENT), mirroring
+     * {@link remoteExecution}. One connection per hostId is cached and reused; a
+     * failed resolve is dropped so a later call can retry once the host is paired.
+     */
+    private remoteFilesystem;
+    private resolveRemoteFilesystem;
+    /**
+     * Resolve the LOCAL read/write filesystem adapter (the consumer's own disk);
+     * throw clearly if absent. This backs the session CONTROL ROOT (persisted
+     * metadata, borrowed bookkeeping, discovery) which always lives on THIS host,
+     * never a remote workspace. Workspace file ops use {@link workspaceFilesystem}.
+     */
+    private filesystem;
+    /**
+     * Resolve the filesystem that backs a session's WORKSPACE. A `{ kind:'host',
+     * hostId }` target with a NON-local hostId reaches THAT host's workspace over
+     * the fleet wire (UNIT-B3, mirroring {@link execution}); local + default + cloud
+     * targets keep resolving the in-process adapter. There is NO silent local
+     * fallback: an unreachable host throws a precise, actionable error.
+     */
+    private workspaceFilesystem;
+    /**
+     * Resolve a session's metadata, attempting attach-on-demand exactly once if
+     * the id is unknown IN THIS PROCESS: a session initialized by a prior process
+     * on this host persisted its metadata under the profile-owned session root (see
+     * `attach()`), so a cold process can still serve it. Concurrent calls for the
+     * same unknown id collapse onto a single attach attempt via `attachInFlight`.
+     */
+    /**
+     * The same trust gate `initialize()` enforces, applied to every path that
+     * can hand out a workspace (attach / attach-on-demand). Without it, a
+     * below-threshold descriptor that could never CREATE a session could still
+     * run commands in one persisted by a higher-trust composition.
+     */
+    private requireTrust;
+    private ensureSession;
+    private requireReadySession;
+    private metadataPath;
+    private borrowedMetadataPath;
+    private operationRoot;
+    private operationDirectory;
+    private operationRecordPath;
+    private operationLeaseDirectory;
+    private readOperationLease;
+    private withOperationLease;
+    private readOperationRecord;
+    private writeOperationRecord;
+    private prepareOperation;
+    private persistSessionMetadata;
+    /** Local discovery contains identity only; the remote workspace owns full metadata. */
+    private persistRemotePointer;
+    private cleanupPath;
+    private readControlMetadata;
+    private loadPersistedSessionMeta;
+    /**
+     * Reattach exactly one requested pre-profile local session.
+     *
+     * This intentionally never participates in discover(): profile isolation
+     * remains the default and no new profile absorbs the process-global legacy
+     * roster. A successful match is copied into this profile as BORROWED, so
+     * teardown cannot delete legacy workspace bytes that may still be referenced
+     * by an older process.
+     */
+    private reattachLegacyLocalSession;
+    /**
+     * Run a one-shot command, capturing output. Used internally for git ops.
+     *
+     * Uses `runtime/execution`'s `spawn()` mode + self-drain rather than
+     * `execute()` on purpose: this method owns a distinct timeout contract
+     * (SIGTERM kill, forced `exitCode:null`, and an explicit
+     * `[code-session] aborted after …` stderr suffix) that `execute()`'s
+     * SIGKILL/137 + no-suffix semantics would change. Keeping spawn()+drain
+     * preserves the exact consumer-observable behavior the characterization
+     * tests pin.
+     */
+    private exec;
+    initialize(input: CodeSessionInitializeInput): Promise<CodeSessionHandle>;
+    createOrGet(input: CodeSessionCreateOrGetInput): Promise<CodeSessionHandle>;
+    private createOrGetOnce;
+    attach(sessionId: string): Promise<CodeSessionHandle>;
+    discover(): Promise<CodeSessionHandle[]>;
+    runCommand(sessionId: string, input: RunCommandInput): Promise<RunCommandResult>;
+    listBackgroundProcesses(sessionId: string): Promise<BackgroundProcessInfo[]>;
+    /**
+     * Keep one background stream's chunks in the entry's ring until the stream
+     * ends. Disposal joins owned work before plugins tear sessions down, so the
+     * read stops when disposal begins instead of holding it for a live process.
+     */
+    private drainBackground;
+    private backgroundEntry;
+    readBackgroundProcess(sessionId: string, procId: string, input?: BackgroundProcessReadInput): Promise<BackgroundProcessOutput>;
+    waitBackgroundProcess(sessionId: string, procId: string, input: BackgroundProcessWaitInput): Promise<BackgroundProcessOutput>;
+    stopBackgroundProcess(sessionId: string, procId: string, signal?: string): Promise<boolean>;
+    pause(sessionId: string): Promise<CodeSessionHandle>;
+    resume(sessionId: string): Promise<CodeSessionHandle>;
+    readFile(sessionId: string, path: string): Promise<string>;
+    writeFile(sessionId: string, path: string, content: string): Promise<void>;
+    patchFile(sessionId: string, input: PatchFileInput): Promise<void>;
+    gitApply(sessionId: string, input: GitApplyInput): Promise<GitApplyResult>;
+    gitStatus(sessionId: string): Promise<GitStatusResult>;
+    private withGitRepoLock;
+    private resolveGitRootForPaths;
+    gitCommit(sessionId: string, input: GitCommitInput, options?: GitCommitOptions): Promise<GitCommitResult>;
+    gitPush(sessionId: string, input?: GitPushInput): Promise<void>;
+    exposePort(sessionId: string, input: ExposePortInput): Promise<ExposePortResult>;
+    teardown(sessionId: string): Promise<void>;
+    private toHandle;
+}
+declare class ConsumerCodeSessionImpl extends ConsumerCodeSession {
+    constructor(descriptor: RuntimeDescriptor | AgentCodeSessionDescriptor, context: KindContext);
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof ConsumerCodeSessionImpl>;
+export default _default;
+//# sourceMappingURL=agent-code-session.impl.consumer.d.ts.map

package/dist/code-session/agent-code-session.impl.consumer.d.ts.map

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