@chipschat/protocol 0.0.0-stage → 1.0.0

package/dist/src/frames.js

@@ -0,0 +1,346 @@
+/**
+ * The WebSocket frames of Appendix B. Frames are the envelope around events on `/v1/ws`:
+ * they carry the handshake, subscription, acknowledgement and liveness that the event
+ * vocabulary itself does not.
+ *
+ * One endpoint serves people and harnesses (decision 5). Every client-originated `event` frame
+ * carries an idempotency key and is answered with `ack {key, seq}`, which is what makes a
+ * reconnect safe: replaying a frame the server already applied changes nothing.
+ */
+import { z } from "zod";
+import { windowChangeFrame, windowCompactFrame } from "./agent-context-windows.js";
+import { heartbeatChangeFrame } from "./agent-heartbeats.js";
+import { modelChangeFrame } from "./agent-models.js";
+import { contextBudget } from "./context.js";
+import { contextEditFrame } from "./context-files.js";
+import { PROTOCOL_VERSION } from "./envelope.js";
+import { jobChangeFrame } from "./harness-jobs.js";
+import { joinRequestView } from "./join.js";
+import { autonomyLevel, id, isoTimestamp } from "./primitives.js";
+import { heldRun } from "./project.js";
+/** The client's half of the handshake. The server answers with a `hello` event. */
+/**
+ * The names a client may give in its `hello`'s `accepts`, and what each brings. Any other name is
+ * taken and ignored: a client built for a newer server says what it understands, and an older
+ * server, which sends none of it, still answers the hello (ADR 0211, Phase 3). Until then a name
+ * the server did not know refused the whole hello, which would have cut every new app off from
+ * every older server.
+ */
+export const SERVER_EXTENSIONS = [
+    "events",
+    "presence",
+    "restart",
+    "join",
+    "context",
+    "models",
+    "heartbeats",
+    "context_windows",
+    "jobs",
+    "folders",
+    "folder_runs",
+];
+export const clientHelloFrame = z
+    .object({
+    frame: z.literal("hello"),
+    protocol: z
+        .object({
+        min: z.int().positive().describe("Oldest major version the client accepts."),
+        max: z.int().positive().describe("Newest major version the client speaks."),
+    })
+        .describe("The client's range. The server picks the highest version both sides support."),
+    client: z
+        .object({
+        name: z.string().min(1).max(120).describe("The harness or app name."),
+        version: z.string().min(1).max(60),
+    })
+        .describe("Who is connecting, for the connection list and for support."),
+    harnesses: z
+        .array(z.object({
+        harness_id: id("harness"),
+        autonomy: autonomyLevel.optional().describe("The level the harness believes it has."),
+    }))
+        .max(64)
+        .optional()
+        .describe("Not read by Chips: a connection is its token's, and the server's `hello` names the token's harness and its agents (ADR 0087). Absent for a person's client."),
+    since: z
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Not read by Chips: a stream resumes from `subscribe`'s `since`."),
+    accepts: z
+        .array(z.string().min(1).max(40))
+        .max(32)
+        .optional()
+        .describe("Server frames beyond the base set this client understands, by the names in `SERVER_EXTENSIONS`. A name the server does not know is ignored rather than refused, so a client may name a frame a newer server sends and still be answered by an older one (ADR 0211, Phase 3). A client that says `events` is sent its replay in pages rather than one frame per event; one that says `presence` is sent an agent's state as it changes (ADR 0083); a harness's socket that says `restart` is sent `restart` when a person asks it to restart (ADR 0094); an owner's or admin's that says `join` is sent each join request as it changes (ADR 0122); a harness's that says `context` is sent `context.edit` when a person changes one of its context files (ADR 0134); a harness's that says `models` is sent `model.change` when a person changes an agent's model or effort (ADR 0140); a harness's that says `heartbeats` is sent `heartbeat.change` when a person switches an agent's heartbeat or changes how often it beats (ADR 0143); a harness's that says `context_windows` is sent `context_window.compact` and `context_window.change` when a person asks an agent to compact now or changes the limit it compacts itself at (ADR 0146); a harness's that says `jobs` is sent `job.change` when a person switches one of the jobs it runs on its own (ADR 0252); a person's that says `folders` is sent `folder.open` when they ask, from another of their devices, for a room's folder to be opened in Finder (ADR 0225), and `folder.run` when they ask for its project to be run or stopped there (ADR 0226); a person's that says `folder_runs` is sent `folder.run_state` when their Mac says how a run of theirs stands (ADR 0226); one that says nothing is sent what it was always sent, since an unknown frame is dropped in silence."),
+    context: contextBudget
+        .optional()
+        .describe("How much of a room a harness is handed with each message for it (ADR 0088): 40 lines and 16,000 characters when absent, 200 and 32,000 at most. For this connection. A person's client is handed none."),
+})
+    .describe("The first frame a client sends.");
+export const subscribeFrame = z
+    .object({
+    frame: z.literal("subscribe"),
+    workspace_id: id("workspace"),
+    space_ids: z
+        .array(id("space"))
+        .max(200)
+        .optional()
+        .describe("Narrow to these spaces. Absent means the whole workspace."),
+    since: z
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Replay from this `seq` before streaming live."),
+})
+    .describe("Ask for a stream. Subscriptions are keyed by workspace and space.");
+export const eventFrame = z
+    .object({
+    frame: z.literal("event"),
+    /** Validated against the catalogue, not here: the frame layer only routes. */
+    event: z.record(z.string(), z.unknown()).describe("Any Agent Connect event."),
+})
+    .describe("Carries one event in either direction.");
+export const eventsFrame = z
+    .object({
+    frame: z.literal("events"),
+    events: z
+        .array(z.record(z.string(), z.unknown()))
+        .max(500)
+        .describe("A page of events, in `seq` order. One store page, as the replay reads them."),
+})
+    .describe("A page of a replay, for a client that asked for them in `hello`. Live events are always single `event` frames.");
+export const ackFrame = z
+    .object({
+    frame: z.literal("ack"),
+    idempotency_key: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe("The key from the frame being acknowledged."),
+    seq: z.int().positive().describe("The sequence number the event was appended at."),
+    duplicate: z
+        .boolean()
+        .default(false)
+        .describe("True when this key had already been applied, so nothing changed."),
+    lane: z
+        .object({
+        lane_id: z.string().min(1).max(120),
+        run_id: z.string().min(1).max(120).describe("The specialist's run, which the lane is."),
+        space_id: z.string().min(1).max(120).describe("The lane's home."),
+    })
+        .optional()
+        .describe("For a `task` that opened a lane: where it lives and which run it is, so a lead that drives the lane itself — a subagent, a Space handed down to — knows where to post. Absent when the task was flattened into a step."),
+    held: z
+        .literal(true)
+        .optional()
+        .describe("The message is in the room, but Chips held it from the agents it named (ADR 0097): the agents have sent each other `exchange.allowance` messages since a person last acted, or a person paused them. Tell the model, so it stops and says what is done and what is blocked rather than waiting on them."),
+    exchange: z
+        .object({
+        count: z.int().nonnegative(),
+        allowance: z.int().positive().optional(),
+    })
+        .optional()
+        .describe("With `held`: the messages between agents since the reset, and the workspace's hold (ADR 0187), absent when it holds them only on a pause."),
+})
+    .describe("The server's answer to a client-originated event.");
+export const receiptFrame = z
+    .object({
+    frame: z.literal("receipt"),
+    idempotency_key: z.string().min(1).max(200),
+    disposition: z
+        .enum(["queued", "steered"])
+        .describe("What Chips did with a message sent mid-run."),
+})
+    .describe("Tells a sender whether their mid-run message was queued or steered.");
+/**
+ * What Chips knows now of a harness (ADR 0083): whether a socket of it is open, and any trouble it
+ * reported. State, not history: chipsd keeps it in memory and writes none of it to the log.
+ */
+export const agentState = z
+    .object({
+    connected: z
+        .boolean()
+        .describe("Whether a socket of it is open. Offline only after 15 seconds without one, so a reconnect never flashes."),
+    since: isoTimestamp.describe("When it connected, or when it went offline."),
+    trouble: z
+        .object({
+        reason: z.string().min(1).max(200).describe("What it said is wrong, in one line."),
+        since: isoTimestamp.describe("When it first said so."),
+    })
+        .optional()
+        .describe("What the harness says is wrong on its side (`PUT /v1/harnesses/:id/status`). Gone when it says it is fine, or when it goes offline."),
+    restarting: z
+        .object({
+        since: isoTimestamp.describe("When a person asked."),
+        by: id("person").describe("Who asked."),
+    })
+        .optional()
+        .describe("A person asked it to restart (`POST /v1/harnesses/:id/restart`, ADR 0094). Gone at its next word, a socket that opens or a status it reports, or three minutes after the ask."),
+})
+    .describe("Whether an agent can answer: connected, not in trouble, and not restarting.");
+export const presenceFrame = z
+    .object({
+    frame: z.literal("presence"),
+    participant_id: id("harness"),
+    state: agentState,
+})
+    .describe("An agent's state changed (ADR 0083). Sent to a person's socket that said `presence` in its `hello`.");
+export const restartFrame = z
+    .object({
+    frame: z.literal("restart"),
+    asked_by: id("person").describe("The person who asked."),
+    asked_at: isoTimestamp.describe("When they asked."),
+})
+    .describe("A person asks the harness to restart (ADR 0094). Sent to a harness's socket that said `restart` in its `hello`, now or never: it is not in the log, so a reconnect never hears it again. What runs is the harness's own restart.");
+export const folderOpenFrame = z
+    .object({
+    frame: z.literal("folder.open"),
+    space_id: id("space").describe("The room whose folder, or page, to open."),
+    what: z
+        .enum(["folder", "page"])
+        .optional()
+        .describe("`page`: open the room's start page, or its one document, in Chips for Mac (ADR 0227). Left out, the folder in Finder."),
+    asked_from: z.string().min(1).max(120).describe("The name of the device that asked: `iPhone`."),
+    asked_at: isoTimestamp.describe("When they asked."),
+})
+    .describe("A person asks their own Mac to open a room's folder in Finder (ADR 0225), or its page in Chips for Mac (ADR 0227), from another of their devices. Sent to that person's sockets that said `folders` in their `hello`, now or never: it is not in the log. The Mac finds the folder and the page itself: nothing here is a path.");
+export const folderRunFrame = z
+    .object({
+    frame: z.literal("folder.run"),
+    space_id: id("space").describe("The room whose project to run, or stop."),
+    op: z.enum(["run", "stop"]),
+    command: z
+        .string()
+        .min(1)
+        .max(1100)
+        .optional()
+        .describe("For `run`, what the asking device showed would run: the Mac runs nothing else, and says so when its folder's run file says something different."),
+    asked_from: z.string().min(1).max(120).describe("The name of the device that asked: `iPhone`."),
+    asked_at: isoTimestamp.describe("When they asked."),
+})
+    .describe("A person asks their own Mac to run a room's project as its run file says, or to stop it (ADR 0226), from another of their devices. Sent to that person's sockets that said `folders` in their `hello`, now or never: it is not in the log. Nothing here is a command: the Mac reads it from the room's folder.");
+export const folderRunStateFrame = z
+    .object({
+    frame: z.literal("folder.run_state"),
+    space_id: id("space"),
+    run: heldRun,
+})
+    .describe("How a person's run of a room's project on their Mac stands (ADR 0226), as that Mac said it. Sent to that person's sockets that said `folder_runs` in their `hello`, never to anyone else's, now or never: `GET /v1/spaces/:id/project/run` reads it again.");
+export const joinFrame = z
+    .object({
+    frame: z.literal("join"),
+    request: joinRequestView,
+})
+    .describe("A join request is waiting, or changed (ADR 0122): asked, allowed, refused, expired or redeemed. Sent to an owner's or admin's socket that said `join` in its `hello`, now or never; `GET /v1/join` reads what is waiting after a reconnect.");
+export const pingFrame = z
+    .object({
+    frame: z.literal("ping"),
+    ts: z
+        .int()
+        .nonnegative()
+        .describe("Sender's clock, in milliseconds, for a round-trip estimate."),
+})
+    .describe("Heartbeat. Every twenty seconds; a silent socket is closed at sixty.");
+export const pongFrame = z
+    .object({ frame: z.literal("pong"), ts: z.int().nonnegative() })
+    .describe("The answer to a ping, echoing its timestamp.");
+/** Error codes are a closed set so a client can branch on them without parsing prose. */
+export const errorCode = z.enum([
+    "protocol_unsupported",
+    "unauthorized",
+    "forbidden",
+    "not_found",
+    "invalid_event",
+    "invalid_frame",
+    "rate_limited",
+    "payload_too_large",
+    "too_far_behind",
+    "budget_exhausted",
+    "stale_file",
+    "stale_context",
+    "internal",
+]);
+export const errorFrame = z
+    .object({
+    frame: z.literal("error"),
+    code: errorCode,
+    message: z.string().min(1).max(2000).describe("What went wrong, in the product voice."),
+    idempotency_key: z
+        .string()
+        .max(200)
+        .optional()
+        .describe("The frame at fault, when there was one."),
+    retry_after_seconds: z.int().nonnegative().optional().describe("When rate limited."),
+    refusal: z
+        .string()
+        .min(1)
+        .max(60)
+        .optional()
+        .describe("Which rule refused the event, for a client that offers a way on: `agent_elsewhere`, `lead_room`, `agent_archived`, `room_closed` (ADR 0087), `agent_deleted` (ADR 0095)."),
+    space_id: z
+        .string()
+        .min(1)
+        .max(120)
+        .optional()
+        .describe("For `agent_elsewhere`: the room the agent is in, where Move takes it from."),
+})
+    .describe("Something went wrong. `too_far_behind` means resume with `since`.");
+export const clientFrame = z
+    .discriminatedUnion("frame", [clientHelloFrame, subscribeFrame, eventFrame, pingFrame, pongFrame])
+    .describe("Anything a client may send.");
+export const serverFrame = z
+    .discriminatedUnion("frame", [
+    eventFrame,
+    eventsFrame,
+    ackFrame,
+    receiptFrame,
+    presenceFrame,
+    restartFrame,
+    joinFrame,
+    folderOpenFrame,
+    folderRunFrame,
+    folderRunStateFrame,
+    contextEditFrame,
+    modelChangeFrame,
+    heartbeatChangeFrame,
+    windowCompactFrame,
+    windowChangeFrame,
+    jobChangeFrame,
+    pingFrame,
+    pongFrame,
+    errorFrame,
+])
+    .describe("Anything the server may send.");
+export const FRAME_NAMES = [
+    "hello",
+    "subscribe",
+    "event",
+    "events",
+    "ack",
+    "receipt",
+    "presence",
+    "restart",
+    "join",
+    "folder.open",
+    "folder.run",
+    "folder.run_state",
+    "context.edit",
+    "model.change",
+    "heartbeat.change",
+    "context_window.compact",
+    "context_window.change",
+    "job.change",
+    "ping",
+    "pong",
+    "error",
+];
+/**
+ * Pick the version both sides speak, or nothing when the ranges do not overlap.
+ * `hello` negotiates `{min, max}` (decision 7).
+ */
+export function negotiateProtocol(client, server = { min: PROTOCOL_VERSION, max: PROTOCOL_VERSION }) {
+    const highest = Math.min(client.max, server.max);
+    const lowest = Math.max(client.min, server.min);
+    return highest >= lowest ? highest : undefined;
+}
+//# sourceMappingURL=frames.js.map

package/dist/src/frames.js.map

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

package/dist/src/harness-jobs.d.ts

@@ -0,0 +1,313 @@
+/**
+ * A harness's own jobs (ADR 0252): what it runs by itself, outside any space, on a schedule of its
+ * own. OpenClaw's are its Main agent's Heartbeat, Dreaming and a Skill review for each agent.
+ *
+ * Nothing about a job is Chips'. A harness that declares `jobs` sends a copy of all of them
+ * (`PUT /v1/harnesses/:id/jobs`), whole, and posts each run it finishes (`POST …/jobs/runs`),
+ * which Chips keeps for `JOB_RUNS_KEPT_DAYS`. A person's change goes down the harness's socket as
+ * a `job.change` frame, and is done when the harness sends its copy again, answering it.
+ */
+import { z } from "zod";
+/** The most jobs a harness's copy lists. */
+export declare const HARNESS_JOBS_MAX = 24;
+/** The most intervals a job offers a person. */
+export declare const JOB_CHOICES_MAX = 12;
+/** The longest interval, in minutes: a year. */
+export declare const JOB_EVERY_MAX = 525600;
+/** The most runs one post carries. */
+export declare const JOB_RUNS_POST_MAX = 200;
+/** The most runs one read gives. */
+export declare const JOB_RUNS_READ_MAX = 500;
+/** How long Chips keeps a run, in days: a harness that keeps a week can still be read for two. */
+export declare const JOB_RUNS_KEPT_DAYS = 90;
+/**
+ * How long a change waits for its harness's answer, as a heartbeat's does (ADR 0143). After it the
+ * change reads as missed; an answer after it still counts, and a new change may be asked.
+ */
+export declare const JOB_CHANGE_WAIT_MS = 60000;
+/** What a job does, for the mark its row wears. */
+export declare const JOB_KINDS: readonly ["heartbeat", "memory", "skills", "other"];
+export declare const jobKind: z.ZodEnum<{
+    memory: "memory";
+    other: "other";
+    heartbeat: "heartbeat";
+    skills: "skills";
+}>;
+export type JobKind = z.infer<typeof jobKind>;
+/** How a run ended. */
+export declare const JOB_RUN_OUTCOMES: readonly ["done", "failed", "stopped"];
+export declare const jobRunOutcome: z.ZodEnum<{
+    failed: "failed";
+    done: "done";
+    stopped: "stopped";
+}>;
+export type JobRunOutcome = z.infer<typeof jobRunOutcome>;
+export declare const jobId: z.ZodString;
+export declare const harnessJob: z.ZodObject<{
+    job_id: z.ZodString;
+    name: z.ZodString;
+    about: z.ZodString;
+    kind: z.ZodEnum<{
+        memory: "memory";
+        other: "other";
+        heartbeat: "heartbeat";
+        skills: "skills";
+    }>;
+    every: z.ZodOptional<z.ZodInt>;
+    when: z.ZodOptional<z.ZodString>;
+    next_at: z.ZodOptional<z.ZodISODateTime>;
+    for_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    on: z.ZodBoolean;
+    editable: z.ZodBoolean;
+    why_read_only: z.ZodOptional<z.ZodString>;
+    choices: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+}, z.core.$strip>;
+export type HarnessJob = z.infer<typeof harnessJob>;
+export declare const harnessJobsPut: z.ZodObject<{
+    jobs: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodString;
+        name: z.ZodString;
+        about: z.ZodString;
+        kind: z.ZodEnum<{
+            memory: "memory";
+            other: "other";
+            heartbeat: "heartbeat";
+            skills: "skills";
+        }>;
+        every: z.ZodOptional<z.ZodInt>;
+        when: z.ZodOptional<z.ZodString>;
+        next_at: z.ZodOptional<z.ZodISODateTime>;
+        for_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        on: z.ZodBoolean;
+        editable: z.ZodBoolean;
+        why_read_only: z.ZodOptional<z.ZodString>;
+        choices: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    }, z.core.$strip>>;
+    answers: z.ZodOptional<z.ZodString>;
+    refuses: z.ZodOptional<z.ZodObject<{
+        change_id: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HarnessJobsPut = z.infer<typeof harnessJobsPut>;
+/** The copy as Chips keeps it: what the harness sent, without what it answered. */
+export type HarnessJobsCopy = Omit<HarnessJobsPut, "answers" | "refuses">;
+export declare const jobRun: z.ZodObject<{
+    job_id: z.ZodString;
+    run_id: z.ZodString;
+    started_at: z.ZodISODateTime;
+    ended_at: z.ZodISODateTime;
+    outcome: z.ZodEnum<{
+        failed: "failed";
+        done: "done";
+        stopped: "stopped";
+    }>;
+    quiet: z.ZodOptional<z.ZodBoolean>;
+    waited: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
+    cost_usd: z.ZodOptional<z.ZodNumber>;
+    tokens: z.ZodOptional<z.ZodInt>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JobRun = z.infer<typeof jobRun>;
+export declare const jobRunsPost: z.ZodObject<{
+    runs: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodString;
+        run_id: z.ZodString;
+        started_at: z.ZodISODateTime;
+        ended_at: z.ZodISODateTime;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            done: "done";
+            stopped: "stopped";
+        }>;
+        quiet: z.ZodOptional<z.ZodBoolean>;
+        waited: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        agent_id: z.ZodOptional<z.ZodString>;
+        cost_usd: z.ZodOptional<z.ZodNumber>;
+        tokens: z.ZodOptional<z.ZodInt>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type JobRunsPost = z.infer<typeof jobRunsPost>;
+export declare const jobChangeAsk: z.ZodObject<{
+    on: z.ZodBoolean;
+    every: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+export type JobChangeAsk = z.infer<typeof jobChangeAsk>;
+export declare const JOB_CHANGE_STATES: readonly ["waiting", "saved", "failed", "missed"];
+export declare const jobChangeState: z.ZodEnum<{
+    waiting: "waiting";
+    saved: "saved";
+    failed: "failed";
+    missed: "missed";
+}>;
+export type JobChangeState = z.infer<typeof jobChangeState>;
+export declare const jobChangeView: z.ZodObject<{
+    change_id: z.ZodString;
+    state: z.ZodEnum<{
+        waiting: "waiting";
+        saved: "saved";
+        failed: "failed";
+        missed: "missed";
+    }>;
+    on: z.ZodBoolean;
+    every: z.ZodOptional<z.ZodInt>;
+    asked_at: z.ZodISODateTime;
+    answered_at: z.ZodOptional<z.ZodISODateTime>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JobChangeView = z.infer<typeof jobChangeView>;
+export declare const harnessJobView: z.ZodObject<{
+    week_usd: z.ZodOptional<z.ZodNumber>;
+    week_runs: z.ZodInt;
+    runs_total: z.ZodInt;
+    last_run: z.ZodOptional<z.ZodObject<{
+        job_id: z.ZodString;
+        run_id: z.ZodString;
+        started_at: z.ZodISODateTime;
+        ended_at: z.ZodISODateTime;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            done: "done";
+            stopped: "stopped";
+        }>;
+        quiet: z.ZodOptional<z.ZodBoolean>;
+        waited: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        agent_id: z.ZodOptional<z.ZodString>;
+        cost_usd: z.ZodOptional<z.ZodNumber>;
+        tokens: z.ZodOptional<z.ZodInt>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    change: z.ZodOptional<z.ZodObject<{
+        change_id: z.ZodString;
+        state: z.ZodEnum<{
+            waiting: "waiting";
+            saved: "saved";
+            failed: "failed";
+            missed: "missed";
+        }>;
+        on: z.ZodBoolean;
+        every: z.ZodOptional<z.ZodInt>;
+        asked_at: z.ZodISODateTime;
+        answered_at: z.ZodOptional<z.ZodISODateTime>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    job_id: z.ZodString;
+    name: z.ZodString;
+    about: z.ZodString;
+    kind: z.ZodEnum<{
+        memory: "memory";
+        other: "other";
+        heartbeat: "heartbeat";
+        skills: "skills";
+    }>;
+    every: z.ZodOptional<z.ZodInt>;
+    when: z.ZodOptional<z.ZodString>;
+    next_at: z.ZodOptional<z.ZodISODateTime>;
+    for_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    on: z.ZodBoolean;
+    editable: z.ZodBoolean;
+    why_read_only: z.ZodOptional<z.ZodString>;
+    choices: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+}, z.core.$strip>;
+export type HarnessJobView = z.infer<typeof harnessJobView>;
+export declare const harnessJobsView: z.ZodObject<{
+    harness_id: z.ZodString;
+    jobs: z.ZodArray<z.ZodObject<{
+        week_usd: z.ZodOptional<z.ZodNumber>;
+        week_runs: z.ZodInt;
+        runs_total: z.ZodInt;
+        last_run: z.ZodOptional<z.ZodObject<{
+            job_id: z.ZodString;
+            run_id: z.ZodString;
+            started_at: z.ZodISODateTime;
+            ended_at: z.ZodISODateTime;
+            outcome: z.ZodEnum<{
+                failed: "failed";
+                done: "done";
+                stopped: "stopped";
+            }>;
+            quiet: z.ZodOptional<z.ZodBoolean>;
+            waited: z.ZodOptional<z.ZodBoolean>;
+            error: z.ZodOptional<z.ZodString>;
+            agent_id: z.ZodOptional<z.ZodString>;
+            cost_usd: z.ZodOptional<z.ZodNumber>;
+            tokens: z.ZodOptional<z.ZodInt>;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        change: z.ZodOptional<z.ZodObject<{
+            change_id: z.ZodString;
+            state: z.ZodEnum<{
+                waiting: "waiting";
+                saved: "saved";
+                failed: "failed";
+                missed: "missed";
+            }>;
+            on: z.ZodBoolean;
+            every: z.ZodOptional<z.ZodInt>;
+            asked_at: z.ZodISODateTime;
+            answered_at: z.ZodOptional<z.ZodISODateTime>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        job_id: z.ZodString;
+        name: z.ZodString;
+        about: z.ZodString;
+        kind: z.ZodEnum<{
+            memory: "memory";
+            other: "other";
+            heartbeat: "heartbeat";
+            skills: "skills";
+        }>;
+        every: z.ZodOptional<z.ZodInt>;
+        when: z.ZodOptional<z.ZodString>;
+        next_at: z.ZodOptional<z.ZodISODateTime>;
+        for_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        on: z.ZodBoolean;
+        editable: z.ZodBoolean;
+        why_read_only: z.ZodOptional<z.ZodString>;
+        choices: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    }, z.core.$strip>>;
+    read_at: z.ZodISODateTime;
+    away: z.ZodBoolean;
+}, z.core.$strip>;
+export type HarnessJobsView = z.infer<typeof harnessJobsView>;
+export declare const jobRunsView: z.ZodObject<{
+    harness_id: z.ZodString;
+    job_id: z.ZodString;
+    runs: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodString;
+        run_id: z.ZodString;
+        started_at: z.ZodISODateTime;
+        ended_at: z.ZodISODateTime;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            done: "done";
+            stopped: "stopped";
+        }>;
+        quiet: z.ZodOptional<z.ZodBoolean>;
+        waited: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        agent_id: z.ZodOptional<z.ZodString>;
+        cost_usd: z.ZodOptional<z.ZodNumber>;
+        tokens: z.ZodOptional<z.ZodInt>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    more: z.ZodBoolean;
+}, z.core.$strip>;
+export type JobRunsView = z.infer<typeof jobRunsView>;
+export declare const jobChangeFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"job.change">;
+    change_id: z.ZodString;
+    harness_id: z.ZodString;
+    job_id: z.ZodString;
+    on: z.ZodBoolean;
+    every: z.ZodOptional<z.ZodInt>;
+    asked_by: z.ZodString;
+    asked_at: z.ZodISODateTime;
+}, z.core.$strip>;
+export type JobChangeFrame = z.infer<typeof jobChangeFrame>;
+//# sourceMappingURL=harness-jobs.d.ts.map