@slopus/happy-agent-client 0.0.0

package/dist/protocol/daemon.js

@@ -0,0 +1,210 @@
+/** The daemon itself: its greeting, health, configuration, and debug surface. */
+import { Type } from "@sinclair/typebox";
+import { effortSchema, Nullable, permissionModeSchema, serviceTierSchema } from "./common.js";
+/**
+ * The wire protocol this client was built for.
+ *
+ * A daemon reports its own number through `GET /v0/health`; a client that reads
+ * a different one refuses to talk to that daemon.
+ */
+export const HAPPY_AGENT_PROTOCOL_VERSION = 17;
+/** `GET /` — a greeting confirming the caller reached a Happy agent. */
+export const greetingResponseSchema = Type.Object({ text: Type.String() });
+/** What a daemon says about itself. */
+export const daemonVersionSchema = Type.Object({
+    /** The product version string, for display and diagnostics. */
+    daemon: Type.String(),
+    /** The wire protocol number; the client's compatibility check. */
+    protocol: Type.Integer(),
+});
+/** `GET /v0/health` */
+export const healthResponseSchema = Type.Object({
+    /** Always `true`; a daemon that cannot answer does not answer. */
+    healthy: Type.Boolean(),
+    /** `false` while the agent system is still loading. */
+    ready: Type.Boolean(),
+    status: Type.Union([Type.Literal("starting"), Type.Literal("ready")]),
+    version: daemonVersionSchema,
+});
+/** What a new agent gets when it names nothing. */
+export const configDefaultsSchema = Type.Object({
+    effort: effortSchema,
+    modelId: Type.String(),
+    permissionMode: permissionModeSchema,
+    providerId: Type.String(),
+});
+export const configFeaturesSchema = Type.Object({
+    crossWorkspace: Type.Boolean(),
+    workflows: Type.Boolean(),
+    workspaces: Type.Boolean(),
+});
+/** A configured MCP server, stripped of everything private. */
+export const mcpServerConfigSchema = Type.Object({
+    enabled: Type.Boolean(),
+    transport: Type.Union([Type.Literal("stdio"), Type.Literal("http")]),
+});
+/** The sandbox network policy. */
+export const networkConfigSchema = Type.Object({
+    allowedDomains: Type.Array(Type.String()),
+    allowedLoopbackPorts: Type.Array(Type.Integer()),
+    allowedPorts: Type.Array(Type.Integer()),
+    allowLocalBinding: Type.Boolean(),
+    deniedDomains: Type.Array(Type.String()),
+});
+/** Peer-to-peer identity and transports. */
+export const p2pConfigSchema = Type.Object({
+    enableDirect: Type.Boolean(),
+    enableIroh: Type.Boolean(),
+    enableSsh: Type.Boolean(),
+    exposeApi: Type.Boolean(),
+    name: Type.String(),
+    role: Type.String(),
+});
+export const permissionsConfigSchema = Type.Object({
+    /** Project-relative paths that mutations must not touch unattended. */
+    protectedPaths: Type.Array(Type.String()),
+});
+/** One presence state the person can be in. */
+export const presenceStateSchema = Type.Object({
+    /** How long a question waits for an answer; `null` waits indefinitely. */
+    answerWaitMs: Nullable(Type.Integer()),
+    emoji: Type.String(),
+    /** What the model is told about the person's availability. */
+    prompt: Type.String(),
+    title: Type.String(),
+});
+export const presenceConfigSchema = Type.Object({
+    current: Type.String(),
+    fallback: Type.String(),
+    states: Type.Record(Type.String(), presenceStateSchema),
+});
+/** Everything a client needs to present a model, defined once. */
+export const modelDefinitionSchema = Type.Object({
+    defaultEffort: effortSchema,
+    efforts: Type.Array(effortSchema),
+    name: Type.String(),
+    /** Empty when the model has no service tiers. */
+    serviceTiers: Type.Array(serviceTierSchema),
+});
+/**
+ * A provider's reference to a model in the top-level catalog.
+ *
+ * A provider serving a model with narrower capabilities than the shared
+ * definition overrides just those fields.
+ */
+export const providerModelReferenceSchema = Type.Object({
+    defaultEffort: Type.Optional(effortSchema),
+    efforts: Type.Optional(Type.Array(effortSchema)),
+    enabled: Type.Boolean(),
+    id: Type.String(),
+    name: Type.Optional(Type.String()),
+    serviceTiers: Type.Optional(Type.Array(serviceTierSchema)),
+});
+export const providerConfigSchema = Type.Object({
+    enabled: Type.Boolean(),
+    models: Type.Array(providerModelReferenceSchema),
+    /** The canonical provider key: `"claude"`, `"codex"`, `"grok"`, … */
+    type: Type.String(),
+});
+/** Daemon behavior toggles and tunables. */
+export const daemonSettingsSchema = Type.Object({
+    compactCompletedTurns: Type.Boolean(),
+    completionChime: Type.Boolean(),
+    inferenceMaxRetries: Type.Integer(),
+    showReasoning: Type.Boolean(),
+    showUsage: Type.Boolean(),
+    toolResultRetentionDays: Type.Integer(),
+});
+/** Terminal color assignments. */
+export const themeConfigSchema = Type.Object({
+    accent: Type.String(),
+    brand: Type.String(),
+    error: Type.String(),
+    primary: Type.String(),
+    secondary: Type.String(),
+    success: Type.String(),
+    warning: Type.String(),
+});
+/** Workspace lifecycle configuration. */
+export const workspaceConfigSchema = Type.Object({
+    keepCopiesOnArchive: Type.Boolean(),
+    keepWorktreesOnArchive: Type.Boolean(),
+    protectedSync: Type.Array(Type.String()),
+    setupCommands: Type.Array(Type.String()),
+    /** Files copied into every new workspace. */
+    sync: Type.Array(Type.String()),
+});
+/** The daemon's effective configuration, with every secret removed. */
+export const daemonConfigSchema = Type.Object({
+    defaults: configDefaultsSchema,
+    features: configFeaturesSchema,
+    mcpServers: Type.Record(Type.String(), mcpServerConfigSchema),
+    /** Every model the daemon knows, keyed by model ID. */
+    models: Type.Record(Type.String(), modelDefinitionSchema),
+    network: networkConfigSchema,
+    p2p: p2pConfigSchema,
+    permissions: permissionsConfigSchema,
+    presence: presenceConfigSchema,
+    providers: Type.Record(Type.String(), providerConfigSchema),
+    settings: daemonSettingsSchema,
+    theme: themeConfigSchema,
+    workspace: workspaceConfigSchema,
+});
+/** `GET /v0/config` */
+export const configResponseSchema = Type.Object({ config: daemonConfigSchema });
+/**
+ * `PATCH /v0/config` — a runtime settings change.
+ *
+ * The specification validates the body against "the mutable subset" without
+ * enumerating it, so the request admits a partial of any group and leaves the
+ * daemon to refuse what it will not change at runtime.
+ */
+export const configPatchSchema = Type.Partial(Type.Object({
+    defaults: Type.Partial(configDefaultsSchema),
+    features: Type.Partial(configFeaturesSchema),
+    network: Type.Partial(networkConfigSchema),
+    p2p: Type.Partial(p2pConfigSchema),
+    permissions: Type.Partial(permissionsConfigSchema),
+    settings: Type.Partial(daemonSettingsSchema),
+    theme: Type.Partial(themeConfigSchema),
+    workspace: Type.Partial(workspaceConfigSchema),
+}));
+/** `GET` and `PUT /v0/config/instructions` */
+export const instructionsResponseSchema = Type.Object({ instructions: Type.String() });
+/** `GET` and `PUT /v0/config/security` */
+export const securityPolicyResponseSchema = Type.Object({ policy: Type.String() });
+/** `POST /v0/shutdown` */
+export const shutdownResponseSchema = Type.Object({
+    /** The daemon's process ID, so the caller can confirm the process exited. */
+    pid: Type.Integer(),
+    shuttingDown: Type.Boolean(),
+});
+/** `POST /v0/debug/inspector` */
+export const inspectorStartedResponseSchema = Type.Object({
+    /** The devtools websocket URL a debugger attaches to. */
+    inspectorUrl: Type.String(),
+});
+/** `DELETE /v0/debug/inspector` */
+export const inspectorStoppedResponseSchema = Type.Object({
+    /** `false` when no inspector was running. */
+    stopped: Type.Boolean(),
+});
+/** `GET /v0/onboarding` */
+export const onboardingStateSchema = Type.Object({
+    /** Set explicitly when the person finished or dismissed onboarding. */
+    completed: Type.Boolean(),
+    steps: Type.Object({
+        /** The profile has a name. */
+        profile: Type.Object({ done: Type.Boolean() }),
+        /** At least one project exists. */
+        project: Type.Object({ done: Type.Boolean() }),
+        /** At least one provider has working credentials. */
+        providers: Type.Object({
+            done: Type.Boolean(),
+            signedIn: Type.Array(Type.String()),
+        }),
+    }),
+});
+/** `POST /v0/onboarding/complete` */
+export const onboardingCompletedResponseSchema = Type.Object({ completed: Type.Boolean() });
+//# sourceMappingURL=daemon.js.map

package/dist/protocol/daemon.js.map

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

package/dist/protocol/events.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Events: everything that changes on the daemon, announced on one journal.
+ *
+ * A client opens with REST snapshots and follows events to stay current. The
+ * journal is a bounded window: a cursor that fell out of it cannot be replayed,
+ * and the daemon says so rather than silently skipping what was lost.
+ */
+import type { Cuid2, EventCursor, ResourceVersion, Timestamp } from "./common.js";
+import type { Agent } from "./agents.js";
+import type { GitState } from "./git.js";
+import type { Message, Run } from "./messages.js";
+import type { BackgroundProcess } from "./processes.js";
+import type { Profile } from "./profile.js";
+import type { Project } from "./projects.js";
+import type { Question } from "./questions.js";
+import type { Terminal } from "./terminals.js";
+import type { Workspace } from "./workspaces.js";
+/**
+ * What every `*.updated` payload carries beside the resource's own ID.
+ *
+ * A client whose cached `version` equals `previousVersion` merges `changes` and
+ * adopts the new version; when they differ its copy is dirty and it refetches
+ * that one resource.
+ */
+export interface ResourceUpdate<TResource> {
+    /** The resource's version before this change. */
+    previousVersion: ResourceVersion;
+    /** Its version after. */
+    version: ResourceVersion;
+    /** Only the fields that changed; `updatedAt` is always among them. */
+    changes: Partial<TResource>;
+    /** Echoed when the mutation behind this change supplied one. */
+    mutationId?: string;
+}
+/** What every mutation-caused payload may carry. */
+export interface MutationEcho {
+    mutationId?: string;
+}
+export type ProjectCreatedPayload = MutationEcho & {
+    project: Project;
+};
+export type ProjectUpdatedPayload = ResourceUpdate<Project> & {
+    projectId: Cuid2;
+};
+export type WorkspaceCreatedPayload = MutationEcho & {
+    workspace: Workspace;
+};
+export type WorkspaceUpdatedPayload = ResourceUpdate<Workspace> & {
+    workspaceId: Cuid2;
+};
+export type TerminalCreatedPayload = MutationEcho & {
+    terminal: Terminal;
+};
+export type TerminalUpdatedPayload = ResourceUpdate<Terminal> & {
+    terminalId: Cuid2;
+};
+/** Git state is computed, so it has no version chain: the payload is the whole snapshot. */
+export interface GitUpdatedPayload {
+    workspaceId: Cuid2;
+    git: GitState;
+}
+export type AgentCreatedPayload = MutationEcho & {
+    agent: Agent;
+};
+export type AgentUpdatedPayload = ResourceUpdate<Agent> & {
+    agentId: Cuid2;
+};
+export type ProcessStartedPayload = MutationEcho & {
+    process: BackgroundProcess;
+};
+export type ProcessUpdatedPayload = ResourceUpdate<BackgroundProcess> & {
+    processId: Cuid2;
+};
+export type QuestionCreatedPayload = MutationEcho & {
+    question: Question;
+};
+export type QuestionUpdatedPayload = ResourceUpdate<Question> & {
+    questionId: Cuid2;
+};
+/** A run began; the agent left `"idle"`. */
+export interface RunStartedPayload extends MutationEcho {
+    agentId: Cuid2;
+    run: Run;
+    /** Pending user messages accepted into the run, oldest first. */
+    acceptedMessageIds: Cuid2[];
+}
+/** User steering atomically closed one run and opened its successor. */
+export interface RunBoundaryPayload extends MutationEcho {
+    agentId: Cuid2;
+    finishedRun: Run;
+    startedRun: Run;
+    /** Pending steering messages accepted into the successor, oldest first. */
+    acceptedMessageIds: Cuid2[];
+}
+/** A run reached a terminal state; the agent is `"idle"` again. */
+export interface RunFinishedPayload extends MutationEcho {
+    agentId: Cuid2;
+    run: Run;
+}
+export interface MessageCreatedPayload extends MutationEcho {
+    agentId: Cuid2;
+    /** `null` for a pending user message, which belongs to no run yet. */
+    runId: Cuid2 | null;
+    message: Message;
+}
+/** The whole message as of now, not a diff. */
+export interface MessageUpdatedPayload extends MutationEcho {
+    agentId: Cuid2;
+    runId: Cuid2;
+    message: Message;
+}
+/**
+ * Streaming text: the one event that is not a full object.
+ *
+ * A client that misses deltas recovers the full message from the next
+ * `message.updated` or from history.
+ */
+export interface MessageDeltaPayload {
+    agentId: Cuid2;
+    runId: Cuid2;
+    messageId: Cuid2;
+    /** Which content block grows. */
+    blockIndex: number;
+    /** Text to concatenate onto that block. */
+    append: string;
+}
+/**
+ * The message is gone from history.
+ *
+ * Deletion happens only when the daemon resets a block of the transcript to
+ * restart inference; the replacements arrive as ordinary `message.created`.
+ */
+export interface MessageDeletedPayload {
+    agentId: Cuid2;
+    runId: Cuid2;
+    messageId: Cuid2;
+}
+/** Deliberately empty: a nudge to refetch the config endpoints when convenient. */
+export type ConfigUpdatedPayload = Record<string, never>;
+export interface ProfileUpdatedPayload extends MutationEcho {
+    profile: Profile;
+}
+/** One event on the journal. */
+export interface EventEnvelope<TType extends string, TPayload> {
+    /** This event's place in the journal; never a resource identity. */
+    cursor: EventCursor;
+    type: TType;
+    occurredAt: Timestamp;
+    payload: TPayload;
+}
+/** Every event the specification names today. */
+export type HappyAgentEvent = EventEnvelope<"project.created", ProjectCreatedPayload> | EventEnvelope<"project.updated", ProjectUpdatedPayload> | EventEnvelope<"workspace.created", WorkspaceCreatedPayload> | EventEnvelope<"workspace.updated", WorkspaceUpdatedPayload> | EventEnvelope<"terminal.created", TerminalCreatedPayload> | EventEnvelope<"terminal.updated", TerminalUpdatedPayload> | EventEnvelope<"git.updated", GitUpdatedPayload> | EventEnvelope<"agent.created", AgentCreatedPayload> | EventEnvelope<"agent.updated", AgentUpdatedPayload> | EventEnvelope<"process.started", ProcessStartedPayload> | EventEnvelope<"process.updated", ProcessUpdatedPayload> | EventEnvelope<"process.exited", ProcessUpdatedPayload> | EventEnvelope<"question.created", QuestionCreatedPayload> | EventEnvelope<"question.updated", QuestionUpdatedPayload> | EventEnvelope<"run.started", RunStartedPayload> | EventEnvelope<"run.boundary", RunBoundaryPayload> | EventEnvelope<"run.finished", RunFinishedPayload> | EventEnvelope<"message.created", MessageCreatedPayload> | EventEnvelope<"message.updated", MessageUpdatedPayload> | EventEnvelope<"message.delta", MessageDeltaPayload> | EventEnvelope<"message.deleted", MessageDeletedPayload> | EventEnvelope<"config.updated", ConfigUpdatedPayload> | EventEnvelope<"profile.updated", ProfileUpdatedPayload>;
+/** The name of an event this client build knows. */
+export type HappyAgentEventType = HappyAgentEvent["type"];
+/** `GET /v0/events` query parameters. */
+export interface EventPageQuery {
+    /** The cursor to read from, exclusive; omitted, reading starts at the oldest. */
+    after?: EventCursor;
+    /** An inclusive upper bound, for pulling the changes between two cursors. */
+    until?: EventCursor;
+    /** Default 100. */
+    limit?: number;
+}
+/** `GET /v0/events` */
+export interface EventPageResponse {
+    /** Oldest first. */
+    events: HappyAgentEvent[];
+    /** Where this page ended; pass it as the next `after`. */
+    cursor: EventCursor;
+    /** The newest event the daemon holds, so a client knows how far behind it is. */
+    latestCursor: EventCursor;
+}
+/** The `hello` frame `GET /v0/events/stream` opens with. */
+export interface EventStreamHello {
+    /** The position the stream continues from. */
+    cursor: EventCursor;
+    /**
+     * The supplied cursor was lost to the journal window. The stream is live
+     * from now, but the client must resync its snapshots.
+     */
+    gap: boolean;
+    /** The supplied cursor was honored; everything since it follows, in order. */
+    resumed: boolean;
+    connectedAt: Timestamp;
+}
+/** One frame read off `GET /v0/events/stream`. */
+export type EventStreamFrame = {
+    kind: "hello";
+    hello: EventStreamHello;
+} | {
+    kind: "event";
+    event: HappyAgentEvent;
+    cursor: EventCursor;
+};
+/** `GET /v0/events/stream` options. */
+export interface EventStreamOptions {
+    /** The cursor to resume from, sent as the `after` query parameter. */
+    after?: EventCursor | undefined;
+    /**
+     * The cursor to resume from, sent as the standard `Last-Event-ID` header.
+     * Equivalent to `after`; both forms exist because SSE reconnects use the
+     * header and a first connection usually names the cursor in the query.
+     */
+    lastEventId?: EventCursor | undefined;
+    /** Closes the connection and ends the iteration. */
+    signal?: AbortSignal | undefined;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/protocol/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../sources/protocol/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,SAAS;IACrC,iDAAiD;IACjD,eAAe,EAAE,eAAe,CAAC;IACjC,yBAAyB;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG;IAAE,WAAW,EAAE,KAAK,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,UAAU,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtF,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,KAAK,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7F,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,UAAU,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtF,4CAA4C;AAC5C,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACnD,OAAO,EAAE,KAAK,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,iEAAiE;IACjE,kBAAkB,EAAE,KAAK,EAAE,CAAC;CAC/B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACpD,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,GAAG,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,2EAA2E;IAC3E,kBAAkB,EAAE,KAAK,EAAE,CAAC;CAC/B;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACpD,OAAO,EAAE,KAAK,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACvD,OAAO,EAAE,KAAK,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACvD,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,KAAK,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEzD,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACvD,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IACzD,oEAAoE;IACpE,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,QAAQ,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACrB,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,GAC3D,aAAa,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,GAC3D,aAAa,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,GACzD,aAAa,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,GACzD,aAAa,CAAC,aAAa,EAAE,iBAAiB,CAAC,GAC/C,aAAa,CAAC,eAAe,EAAE,mBAAmB,CAAC,GACnD,aAAa,CAAC,eAAe,EAAE,mBAAmB,CAAC,GACnD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,GACtD,aAAa,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,GACzD,aAAa,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,GACzD,aAAa,CAAC,aAAa,EAAE,iBAAiB,CAAC,GAC/C,aAAa,CAAC,cAAc,EAAE,kBAAkB,CAAC,GACjD,aAAa,CAAC,cAAc,EAAE,kBAAkB,CAAC,GACjD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,eAAe,EAAE,mBAAmB,CAAC,GACnD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,aAAa,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,GACrD,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AAE9D,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE1D,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC3B,iFAAiF;IACjF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uBAAuB;AACvB,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,MAAM,EAAE,WAAW,CAAC;IACpB,iFAAiF;IACjF,YAAY,EAAE,WAAW,CAAC;CAC7B;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,GAAG,EAAE,OAAO,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,SAAS,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAErE,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAC/B,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACpC"}

package/dist/protocol/events.js

@@ -0,0 +1,9 @@
+/**
+ * Events: everything that changes on the daemon, announced on one journal.
+ *
+ * A client opens with REST snapshots and follows events to stay current. The
+ * journal is a bounded window: a cursor that fell out of it cannot be replayed,
+ * and the daemon says so rather than silently skipping what was lost.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/protocol/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../sources/protocol/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/protocol/files.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Files: read-mostly access to a workspace's folder.
+ *
+ * Every path is relative to the workspace root; absolute paths, `..`, and
+ * symlinks escaping the root are rejected by the daemon.
+ */
+/** One hit from the filename search. */
+export interface FileMatch {
+    path: string;
+    fileName: string;
+}
+/** `GET /v0/workspaces/:workspaceId/files` query parameters. */
+export interface FileSearchQuery {
+    query: string;
+    limit?: number;
+}
+/** `GET /v0/workspaces/:workspaceId/files` */
+export interface FileSearchResponse {
+    files: FileMatch[];
+}
+/** One entry of a directory listing. */
+export interface FileTreeEntry {
+    name: string;
+    path: string;
+    type: "file" | "directory" | "symlink" | "other";
+    size: number;
+    modified: number;
+}
+/** `GET /v0/workspaces/:workspaceId/file-tree` query parameters. */
+export interface FileTreeQuery {
+    /** Defaults to the workspace root. */
+    path?: string;
+    cursor?: string;
+    limit?: number;
+}
+/** `GET /v0/workspaces/:workspaceId/file-tree` */
+export interface FileTreeResponse {
+    entries: FileTreeEntry[];
+    nextCursor: string | null;
+}
+/** `GET /v0/workspaces/:workspaceId/file` */
+export interface FileContentResponse {
+    /** Base64, because files are bytes and not necessarily text. */
+    content: string;
+    /** The sha256 hex digest, which is the write guard. */
+    hash: string;
+}
+/** `PUT /v0/workspaces/:workspaceId/file` */
+export interface WriteFileRequest {
+    path: string;
+    /** Base64 file content. */
+    content: string;
+    /**
+     * The compare-and-swap: the sha256 the client read, or `null` to require
+     * that the file not exist yet.
+     */
+    expectedHash: string | null;
+}
+/** `PUT /v0/workspaces/:workspaceId/file` */
+export interface WriteFileResponse {
+    hash: string;
+}
+/** `GET /v0/workspaces/:workspaceId/file-revision` query parameters. */
+export interface FileRevisionQuery {
+    path: string;
+    /** A commit-ish. */
+    revision: string;
+}
+/** `GET /v0/workspaces/:workspaceId/file-revision` */
+export interface FileRevisionResponse {
+    /** Base64 file content as of the revision. */
+    content: string;
+}
+//# sourceMappingURL=files.d.ts.map

package/dist/protocol/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../sources/protocol/files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC1B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAChC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACjC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACnB"}

package/dist/protocol/files.js

@@ -0,0 +1,8 @@
+/**
+ * Files: read-mostly access to a workspace's folder.
+ *
+ * Every path is relative to the workspace root; absolute paths, `..`, and
+ * symlinks escaping the root are rejected by the daemon.
+ */
+export {};
+//# sourceMappingURL=files.js.map

package/dist/protocol/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../sources/protocol/files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/protocol/git.d.ts

@@ -0,0 +1,55 @@
+/** Git state: branch and sync facts plus the working tree's changes. */
+import type { Cuid2, GitSummary, Timestamp } from "./common.js";
+/** What happened to a single changed file. */
+export type GitFileStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "untracked" | "conflicted" | "type_changed" | "submodule";
+export interface GitFileChange {
+    path: string;
+    status: GitFileStatus;
+    staged: boolean;
+    unstaged: boolean;
+    binary: boolean;
+    insertions: number;
+    deletions: number;
+}
+/**
+ * The git state object.
+ *
+ * Git state is computed rather than mutated, so it carries no version chain:
+ * the newest snapshot simply replaces what a client held.
+ */
+export interface GitState {
+    facts: GitSummary;
+    /** `"unavailable"` when no sensible base exists yet; then only `facts` mean anything. */
+    comparison: "ready" | "unavailable";
+    /** What the changes are measured against. */
+    base: string | null;
+    changedFiles: number;
+    insertions: number;
+    deletions: number;
+    /** `false` when a large tree made the daemon estimate. */
+    countsExact: boolean;
+    conflicted: boolean;
+    files: GitFileChange[];
+    /** `true` when the file list was capped. */
+    filesTruncated: boolean;
+    scannedAt: Timestamp;
+}
+/** `GET /v0/workspaces/:workspaceId/git` */
+export interface GitStateResponse {
+    git: GitState;
+}
+/** `POST /v0/git/watch` */
+export interface WatchGitRequest {
+    workspaceIds: Cuid2[];
+}
+/**
+ * `POST /v0/git/watch`
+ *
+ * Whatever the watcher already knows for the requested workspaces. A repository
+ * it has not scanned yet is simply absent, and its first `git.updated` event
+ * follows shortly.
+ */
+export interface WatchGitResponse {
+    snapshots: Record<string, GitState>;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/protocol/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../sources/protocol/git.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,MAAM,aAAa,GACnB,OAAO,GACP,UAAU,GACV,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,cAAc,GACd,WAAW,CAAC;AAElB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,yFAAyF;IACzF,UAAU,EAAE,OAAO,GAAG,aAAa,CAAC;IACpC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,4CAA4C;IAC5C,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,KAAK,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACvC"}

package/dist/protocol/git.js

@@ -0,0 +1,3 @@
+/** Git state: branch and sync facts plus the working tree's changes. */
+export {};
+//# sourceMappingURL=git.js.map

package/dist/protocol/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../sources/protocol/git.ts"],"names":[],"mappings":"AAAA,wEAAwE"}