@gtc6244/immediacy-daemon 0.1.0

package/dist/src/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,MAAM,CAAC,GAAG,GAAoE,CAAC;IAC/E,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAClB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC/D,mEAAmE;IACnE,IAAI,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,mBAAmB,KAAK,CAAC,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC;IAC9B,OAAO;QACL,WAAW;QACX,YAAY;QACZ,eAAe;QACf,mBAAmB;QACnB,OAAO,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KAC9E,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,0DAA0D;AAC1D,SAAS,MAAM,CAAC,CAAS;IACvB,IAAI,CAAC,IAAI,SAAS;QAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAClE,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,CAAY;IAC1C,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,mBAAmB,CAAC;IAC1E,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;IAChE,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;QAAE,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/workspace.d.ts

@@ -0,0 +1,303 @@
+/**
+ * WorkspaceManager — owns the set of workspaces and, per workspace, its
+ * worktree, agent, and terminal. Translates agent events into broadcast wire
+ * messages and persists metadata so sessions survive a daemon restart (resume).
+ */
+import type { WebSocket } from "ws";
+import type { ChatEntry, DeleteBatchResultPayload, PromptAttachment, QuestionAnswers, WorkspaceActionKind, WorkspaceSummary } from "./protocol.js";
+import type { ProjectRecord, WorkspaceRecord } from "./types.js";
+import type { Hub } from "./hub.js";
+import type { SystemEvents } from "./events.js";
+import { ChatLog } from "./chatlog.js";
+import { ProjectStore } from "./projects.js";
+import { AppConfigStore } from "./config.js";
+import { CredentialsStore } from "./credentials.js";
+import { AllowlistStore } from "./allowlist.js";
+import type { PermissionResponse } from "./agent/agent.js";
+export declare class WorkspaceManager {
+    private hub;
+    /** Durable per-workspace transcript, so history survives phone reboots. */
+    private chatlog;
+    /**
+     * In-process domain-event bus. Optional so existing callers/tests need no
+     * change; when present, the manager emits at each action chokepoint so the
+     * JobScheduler can drive reactive ("N minutes after X") triggers.
+     */
+    private events?;
+    /** Registry of projects worktrees hang under (persisted separately). */
+    private projects;
+    /**
+     * Provider API keys (app-managed, env-seeded). Read at agent-spawn time to
+     * pick a session's credential: a stored/env key, else the CLI/SDK's own SSO
+     * login. Defaulted so existing callers/tests need no change.
+     */
+    private credentials;
+    /**
+     * Daemon-owned app config (prompts + git behavior). Read live at spawn time
+     * (`prompts.general` → agent system prompt) and at worktree-create time
+     * (`git.branchPrefix*`). Defaulted so existing callers/tests need no change.
+     */
+    private appConfig;
+    /**
+     * Daemon-global "Allow all" list. Handed to every spawned agent so a prior
+     * grant auto-approves matching calls, and appended to when a client answers
+     * a permission request with `allow_all`. Defaulted for existing callers/tests.
+     */
+    private allowlist;
+    private workspaces;
+    /**
+     * The last workspace list we fanned out, JSON-encoded — so
+     * `broadcastWorkspaceList` can no-op when a recompute yields identical rows.
+     */
+    private lastListJson;
+    constructor(hub: Hub, 
+    /** Durable per-workspace transcript, so history survives phone reboots. */
+    chatlog?: ChatLog, 
+    /**
+     * In-process domain-event bus. Optional so existing callers/tests need no
+     * change; when present, the manager emits at each action chokepoint so the
+     * JobScheduler can drive reactive ("N minutes after X") triggers.
+     */
+    events?: SystemEvents | undefined, 
+    /** Registry of projects worktrees hang under (persisted separately). */
+    projects?: ProjectStore, 
+    /**
+     * Provider API keys (app-managed, env-seeded). Read at agent-spawn time to
+     * pick a session's credential: a stored/env key, else the CLI/SDK's own SSO
+     * login. Defaulted so existing callers/tests need no change.
+     */
+    credentials?: CredentialsStore, 
+    /**
+     * Daemon-owned app config (prompts + git behavior). Read live at spawn time
+     * (`prompts.general` → agent system prompt) and at worktree-create time
+     * (`git.branchPrefix*`). Defaulted so existing callers/tests need no change.
+     */
+    appConfig?: AppConfigStore, 
+    /**
+     * Daemon-global "Allow all" list. Handed to every spawned agent so a prior
+     * grant auto-approves matching calls, and appended to when a client answers
+     * a permission request with `allow_all`. Defaulted for existing callers/tests.
+     */
+    allowlist?: AllowlistStore);
+    /** The daemon-global allowlist (for server-side admin: list/revoke/clear). */
+    allowlistStore(): AllowlistStore;
+    /** Is there a live workspace with this id? (used by the job scheduler). */
+    has(id: string): boolean;
+    load(): Promise<void>;
+    /** Registered projects (the sidebar groups). */
+    listProjects(): ProjectRecord[];
+    /**
+     * Reorder the registered projects. `ids` is the full list of project ids in
+     * the desired display order (see ProjectStore.reorder for how unknown/missing
+     * ids are handled).
+     */
+    reorderProjects(ids: string[]): Promise<void>;
+    /**
+     * Register a project from a blank repo (`git init`), a GitHub source, or an
+     * existing local path. GitHub/local are idempotent (by full name / resolved
+     * path); blank always creates. Does NOT create a worktree — it's a standing
+     * "+ new worktree" target.
+     */
+    createProject(opts: {
+        blank?: boolean;
+        repo?: string;
+        github?: {
+            fullName: string;
+            defaultBranch?: string;
+        };
+        name?: string;
+    }): Promise<ProjectRecord>;
+    /**
+     * Branches available to base a new worktree on for a project (local + remote,
+     * deduped). Powers the "create worktree from an existing branch" pickers.
+     */
+    listBranches(projectId: string): Promise<{
+        branches: string[];
+        defaultBranch?: string;
+    }>;
+    /**
+     * A project's open pull requests, for the "create worktree from an open PR"
+     * picker. Empty when the project has no GitHub remote or `gh` isn't available.
+     */
+    listPullRequests(projectId: string): Promise<import("./protocol.js").PullRequestSummary[]>;
+    /**
+     * A project's open issues (with bodies), for the "create worktree from an
+     * issue" picker + confirm step. Empty when there's no GitHub remote / gh.
+     */
+    listIssues(projectId: string): Promise<import("./protocol.js").IssueSummary[]>;
+    /** Remove a project. Rejected while any worktree still references it. */
+    deleteProject(id: string): Promise<void>;
+    /** Persisted transcript for a workspace (chronological). */
+    history(id: string): ChatEntry[];
+    private persist;
+    list(): WorkspaceRecord[];
+    /**
+     * Create a workspace (worktree) under a project. Preferred: pass `projectId`.
+     * The legacy path — a bare `repo`/`github` with no projectId — find-or-creates
+     * the matching project first, so every worktree ends up grouped.
+     */
+    create(opts: {
+        projectId?: string;
+        repo?: string;
+        github?: {
+            fullName: string;
+            defaultBranch?: string;
+        };
+        name?: string;
+        branchBase?: string;
+        /** Check out this existing branch instead of forking a fresh one. */
+        sourceBranch?: string;
+        /** Check out this open PR's head branch instead of forking a fresh one. */
+        sourcePr?: number;
+        /** Seed the agent with this first prompt right after creation. */
+        initialPrompt?: string;
+        model?: string;
+    }): Promise<WorkspaceRecord>;
+    /**
+     * Create a repo-less "chat" workspace — a free-form conversation with the
+     * agent, not tied to any GitHub project or git worktree (the Claude/ChatGPT
+     * desktop model). It starts named "New Chat"; the first prompt triggers an
+     * auto-title (see `prompt`). The agent still gets a real cwd — a private
+     * scratch dir under `~/.immediacy/chats/<id>` — so file/bash tools work,
+     * scoped to that folder by the usual workspace-scope rule.
+     */
+    createChat(opts?: {
+        model?: string;
+    }): Promise<WorkspaceRecord>;
+    /**
+     * Rename a workspace and fan the new label out to every client. Used by the
+     * chat auto-title flow; the sidebar row updates in place without a full list
+     * refresh.
+     */
+    private renameWorkspace;
+    /**
+     * Summarize a chat's first prompt into a short title and rename the workspace.
+     * Fire-and-forget: guards against a racing second prompt (only renames while
+     * the label is still the placeholder) and swallows any failure.
+     */
+    private autoTitleChat;
+    /** Added/removed line totals vs base, per workspace (for the sidebar rows). */
+    diffStat(id: string): Promise<import("./worktree.js").DiffStat | null>;
+    /**
+     * The sidebar summaries: one row per workspace with its live diff-stat. Diffs
+     * are measured in parallel and best-effort (0/0 on any git hiccup); `added`/
+     * `removed` are omitted when zero so a clean worktree renders no counter.
+     */
+    summaries(): Promise<WorkspaceSummary[]>;
+    /**
+     * Recompute the sidebar summaries and fan them out to every client — but only
+     * when something actually changed since the last fan-out. This is the single
+     * entry point for keeping the left-pane rows (diff-stat counters, name,
+     * branch, status) live: callers fire it whenever a worktree's state may have
+     * moved (an agent turn finished, files changed, the base advanced, a branch or
+     * PR was renamed) without having to know whether the numbers really shifted.
+     * The change-check keeps a frequently-polled path (git.status) from spamming
+     * identical lists at every connected device.
+     */
+    broadcastWorkspaceList(): Promise<void>;
+    /**
+     * Freshen every base repo's remote-tracking refs, then reconcile the sidebar.
+     * This is the "an app just (re)connected — make the left pane reflect GitHub,
+     * not a snapshot from whenever we last fetched" path: the client's first
+     * `workspace.list` gets an immediate (locally-computed) reply for a snappy
+     * paint, and this runs alongside it so a since-pushed base lands a moment
+     * later. One fetch per distinct repo, throttled + coalesced per repo (see
+     * maybeSyncRepo), so a workspace-heavy account still costs one fetch per repo
+     * per interval; the broadcast's change-check no-ops when nothing moved.
+     * Best-effort — an offline/no-remote repo keeps its last-known refs.
+     */
+    syncAllReposAndRefresh(): Promise<void>;
+    delete(id: string): Promise<void>;
+    /** Tear down a repo-less chat: stop the agent, drop its scratch dir + log. */
+    private deleteChat;
+    /**
+     * Archive a workspace: a deliberate teardown that force-removes the worktree
+     * (discarding any uncommitted changes) and — only when
+     * git.deleteBranchOnArchive is set — deletes the *local* branch. The remote
+     * (pushed branch, PR, commits on origin) is never touched, so archiving a
+     * merged workspace is non-destructive to the shipped work. Distinct from
+     * delete, which always preserves the branch (§11).
+     */
+    archive(id: string): Promise<void>;
+    /**
+     * Run a prompt-backed agent action (code review, create PR, fix errors,
+     * resolve merge conflicts, rename branch). Composes the built-in instruction
+     * plus the user's matching prompts.* custom text, then injects it through the
+     * normal prompt path — the agent does the work with its own permission-gated
+     * tools. Returns false when the workspace is unknown.
+     */
+    runAction(id: string, kind: WorkspaceActionKind): boolean;
+    /**
+     * Mass-delete worktrees and/or whole projects. Selected projects contribute
+     * all of their remaining worktrees to the removal set (a project can't be
+     * deleted while any worktree still references it), then the projects
+     * themselves are removed. Each item is attempted independently: a dirty
+     * worktree that refuses removal is collected as a failure rather than
+     * aborting the rest — and its owning project then fails too (correctly, since
+     * it still has a worktree). Callers broadcast fresh lists afterwards.
+     */
+    deleteBatch(opts: {
+        workspaces?: string[];
+        projects?: string[];
+    }): Promise<DeleteBatchResultPayload>;
+    prompt(id: string, text: string, attachments?: PromptAttachment[]): void;
+    /**
+     * Interrupt the running agent turn. The session itself survives (its id is
+     * persisted), so the next prompt resumes the conversation in a fresh agent.
+     */
+    stopAgent(id: string): Promise<void>;
+    respondPermission(id: string, requestId: string, decision: PermissionResponse): void;
+    answerQuestion(id: string, requestId: string, answers: QuestionAnswers, response?: string): void;
+    diff(id: string): Promise<import("./protocol.js").DiffFile[] | null>;
+    /** Full-codebase file listing for a workspace. */
+    tree(id: string): Promise<string[] | null>;
+    /** Read one worktree-relative file (for the in-app viewer). */
+    readFile(id: string, path: string): Promise<import("./worktree.js").FileContent | null>;
+    /** Overwrite one worktree file (in-app editor save). Returns bytes written, or null for an unknown workspace. */
+    writeFile(id: string, path: string, content: string): Promise<number | null>;
+    /** Get (or create) a device's terminal slot, re-binding it to `socket`. */
+    private deviceTerm;
+    /**
+     * Dispose any terminal keyed by `deviceId` across every workspace. Called when
+     * a socket closes, passing that connection's fallback `connId`: a client that
+     * sends no stable deviceId gets a fresh connId per connection, so without this
+     * its PTY would leak on every reconnect. Terminals under a *stable* deviceId
+     * are intentionally left intact so their scrollback survives a reconnect.
+     */
+    reapDevice(deviceId: string): void;
+    terminalInput(id: string, deviceId: string, data: string, socket: WebSocket): void;
+    terminalResize(id: string, deviceId: string, cols: number, rows: number, socket: WebSocket): void;
+    /** This device's retained PTY scrollback ("" until it has started one). */
+    terminalSnapshot(id: string, deviceId: string, socket: WebSocket): string | null;
+    gitStatus(id: string, sync?: boolean): Promise<import("./protocol.js").GitStatusResultPayload | null>;
+    gitCommit(id: string, message: string): Promise<import("./protocol.js").GitResultPayload | null>;
+    gitPush(id: string): Promise<import("./protocol.js").GitResultPayload | null>;
+    gitResolve(id: string): Promise<import("./protocol.js").GitResultPayload | null>;
+    gitMerge(id: string, action: "ours" | "theirs" | "commit" | "abort", paths?: string[]): Promise<import("./protocol.js").GitResultPayload | null>;
+    prCreate(id: string, title: string, body?: string): Promise<import("./protocol.js").GitResultPayload | null>;
+    /** Merge the workspace branch's open PR on the remote (`gh pr merge`). */
+    prMerge(id: string): Promise<import("./protocol.js").GitResultPayload | null>;
+    /**
+     * Open a GitHub issue from a workspace's output — the mirror of `prCreate`.
+     * The result rides the shared `git.result` channel (`op: "issue"`) so clients
+     * reuse their existing PR-create plumbing (busy state, result banner).
+     */
+    issueCreate(id: string, title: string, body?: string): Promise<{
+        ws: string;
+        op: "issue";
+        ok: boolean;
+        message: string;
+        url?: undefined;
+    } | {
+        ws: string;
+        op: "issue";
+        ok: boolean;
+        message: string;
+        url: string;
+    } | null>;
+    open(id: string, target: "finder" | "terminal" | "editor"): Promise<void>;
+    private spawnAgent;
+    private onAgentEvent;
+    private setStatus;
+    shutdown(): Promise<void>;
+}