@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/contract/github.d.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 /**
  * One issue or pull request, flattened for the cockpit (`ForgeItem` server-side).
- * A protected shape — BACKWARD_COMPATIBILITY.md §2 forbids reshaping it.
+ * A protected shape — BACKWARD_COMPATIBILITY.md §2 forbids reshaping it outside a documented
+ * deprecation. `body` is in one (hearsay-tools/cezarion#1183): optional, still sent by list
+ * routes, and hydrated from `detail.body` on the comments route by new consumers.
  */
 export declare const githubItemSchema: z.ZodObject<{
     kind: z.ZodEnum<{
@@ -13,7 +15,7 @@ export declare const githubItemSchema: z.ZodObject<{
     author: z.ZodString;
     createdAt: z.ZodString;
     labels: z.ZodArray<z.ZodString>;
-    body: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
     url: z.ZodString;
     comments: z.ZodNumber;
     assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -44,7 +46,7 @@ export declare const githubItemResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObj
         author: z.ZodString;
         createdAt: z.ZodString;
         labels: z.ZodArray<z.ZodString>;
-        body: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
         url: z.ZodString;
         comments: z.ZodNumber;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -100,7 +102,7 @@ export declare const githubDataSchema: z.ZodObject<{
         author: z.ZodString;
         createdAt: z.ZodString;
         labels: z.ZodArray<z.ZodString>;
-        body: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
         url: z.ZodString;
         comments: z.ZodNumber;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -124,7 +126,7 @@ export declare const githubDataSchema: z.ZodObject<{
         author: z.ZodString;
         createdAt: z.ZodString;
         labels: z.ZodArray<z.ZodString>;
-        body: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
         url: z.ZodString;
         comments: z.ZodNumber;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -152,8 +154,51 @@ export declare const githubDataSchema: z.ZodObject<{
         unavailable: "unavailable";
     }>>;
     projectsGeneration: z.ZodOptional<z.ZodString>;
+    issuesTotal: z.ZodOptional<z.ZodNumber>;
+    prsTotal: z.ZodOptional<z.ZodNumber>;
+    issuesNextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prsNextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    commentsDeferred: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 export type GithubData = z.infer<typeof githubDataSchema>;
+/** Longest opaque page cursor the list route accepts. GitHub's are well under 100 characters. */
+export declare const GITHUB_CURSOR_MAX = 2000;
+/**
+ * `GET /api/v1/github` query (hearsay-tools/cezarion#1183). Each side pages on its own: a side
+ * whose previous page answered `nextCursor: null` is sent as `<side>Done=1` so the server never
+ * restarts it while the other side keeps paging. `limit` stays a bare string — the handler's
+ * fallback to 30 already accepts `?limit=banana`.
+ */
+export declare const githubListQuerySchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodString>;
+    refresh: z.ZodOptional<z.ZodString>;
+    issuesCursor: z.ZodOptional<z.ZodString>;
+    prsCursor: z.ZodOptional<z.ZodString>;
+    issuesDone: z.ZodOptional<z.ZodLiteral<"1">>;
+    prsDone: z.ZodOptional<z.ZodLiteral<"1">>;
+}, z.core.$strip>;
+export type GithubListQuery = z.infer<typeof githubListQuerySchema>;
+/** Most numbers one comment-count request may name — the same cap as `/github/checks`. */
+export declare const GITHUB_COMMENT_COUNTS_MAX = 100;
+/** `GET /api/v1/github/comment-counts` query (hearsay-tools/cezarion#1183). */
+export declare const githubCommentCountsQuerySchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        issue: "issue";
+        pr: "pr";
+    }>;
+    numbers: z.ZodString;
+    refresh: z.ZodOptional<z.ZodLiteral<"1">>;
+}, z.core.$strip>;
+export type GithubCommentCountsQuery = z.infer<typeof githubCommentCountsQuerySchema>;
+/** Comment counts for list rows, hydrated after first paint. An absent number means unknown. */
+export declare const githubCommentCountsDataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    available: z.ZodLiteral<true>;
+    counts: z.ZodRecord<z.ZodNumber, z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    available: z.ZodLiteral<false>;
+    reason: z.ZodString;
+}, z.core.$strip>], "available">;
+export type GithubCommentCountsData = z.infer<typeof githubCommentCountsDataSchema>;
 /**
  * `GET /api/v1/github/checks?prs=…` (#664) — lazy PR checks glyphs, `number → glyph`. The list
  * call no longer ships `statusCheckRollup`, so a row's glyph is hydrated here for the on-screen
@@ -207,7 +252,7 @@ export declare const githubSearchDataSchema: z.ZodObject<{
         author: z.ZodString;
         createdAt: z.ZodString;
         labels: z.ZodArray<z.ZodString>;
-        body: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
         url: z.ZodString;
         comments: z.ZodNumber;
         assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -226,27 +271,8 @@ export declare const githubSearchDataSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type GithubSearchData = z.infer<typeof githubSearchDataSchema>;
 /**
- * Where a referenced PR or issue STANDS — the vocabulary a task's tracker chip paints.
- *
- * One flat enum rather than a per-kind union, because the chip renders one status and a union
- * would make every consumer narrow on `kind` before it could pick a color. The kinds share no
- * value on purpose: a closed PR (abandoned — red) and a closed issue (`completed` — done, violet)
- * are opposite outcomes wearing the same English word, and collapsing them is how a merged-looking
- * task turns out to have been dropped.
- *
- * PR values: `merged`, `closed` (closed WITHOUT merging), `draft`, `checks-pending`,
- * `changes-requested`, `checks-failing`, `review-required`, `ready`. Issue values: `open`,
- * `completed`, `not-planned`.
- *
- * Which one a PR gets is `derivePrReferenceStatus`'s ranking (server-side, and documented there):
- * it answers "what is this waiting on right now", so it ranks by how FRESH a signal is rather
- * than by how heavy a blocker it is — running checks mean a commit was just pushed, and a
- * requested change the author has already pushed past is not what the PR is waiting on.
- *
- * `ready` is the honest reading of "nothing is blocking it here": open, not a draft, no failing or
- * running checks, and no review the forge is still waiting on. It is NOT a mergeability probe —
- * that is `githubPrMergeStateResponseSchema`, which costs a request per PR; this is one batched
- * query for a whole table.
+ * Shared reference-status vocabulary for PRs and issues. Closed PR and completed issue remain
+ * distinct outcomes. Server ranking describes the next action; merge conflict is independent.
  */
 export declare const referenceStatusSchema: z.ZodEnum<{
     "changes-requested": "changes-requested";
@@ -453,6 +479,11 @@ export declare const githubCommentsDataSchema: z.ZodObject<{
         refTitle: z.ZodOptional<z.ZodString>;
         refIsPr: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
+    detail: z.ZodOptional<z.ZodObject<{
+        body: z.ZodString;
+        additions: z.ZodOptional<z.ZodNumber>;
+        deletions: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GithubCommentsData = z.infer<typeof githubCommentsDataSchema>;
 export declare const githubMergeMethodSchema: z.ZodEnum<{
@@ -496,6 +527,7 @@ export declare const githubPrMergeStateSchema: z.ZodObject<{
     reviewDecision: z.ZodEnum<{
         approved: "approved";
         "changes-requested": "changes-requested";
+        "not-required": "not-required";
         "review-required": "review-required";
         unknown: "unknown";
     }>;
@@ -560,6 +592,7 @@ export declare const githubPrMergeStateResponseSchema: z.ZodDiscriminatedUnion<[
         reviewDecision: z.ZodEnum<{
             approved: "approved";
             "changes-requested": "changes-requested";
+            "not-required": "not-required";
             "review-required": "review-required";
             unknown: "unknown";
         }>;

package/dist/contract/handoff.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * The handoff journal (`.ai/cezar/runs/<runId>.handoff.md`, spec 007) as the server and the
+ * cockpit both read it. The agent writes the file; cezar keeps its own records in the run store
+ * and writes them into the file as one block that it rewrites whole (hearsay-tools/cezarion#1809).
+ */
+/** How many autosave records a run keeps, newest first. */
+export declare const HANDOFF_AUTOSAVE_RECORDS_MAX = 20;
+/** One autosave report. `note` is the line as the block shows it; `periodic` holds the fields that
+ *  consecutive timer commits on one branch are merged on (`branch: null` is a detached HEAD, a
+ *  `null` sha one that could not be read back). */
+export declare const handoffAutosaveRecordSchema: z.ZodObject<{
+    at: z.ZodString;
+    note: z.ZodString;
+    periodic: z.ZodOptional<z.ZodObject<{
+        branch: z.ZodNullable<z.ZodString>;
+        count: z.ZodNumber;
+        first: z.ZodNullable<z.ZodString>;
+        latest: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HandoffAutosaveRecord = z.infer<typeof handoffAutosaveRecordSchema>;
+/** `RunRecord.handoffRecords`: cezar's own records for the run's handoff file, newest first. */
+export declare const handoffRecordsSchema: z.ZodObject<{
+    autosave: z.ZodArray<z.ZodObject<{
+        at: z.ZodString;
+        note: z.ZodString;
+        periodic: z.ZodOptional<z.ZodObject<{
+            branch: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+            first: z.ZodNullable<z.ZodString>;
+            latest: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HandoffRecords = z.infer<typeof handoffRecordsSchema>;
+/** Index of the first line of `text` that is exactly `line`, or -1. Every handoff header lookup
+ *  goes through it, so a Goal that quotes a header is never taken for one
+ *  (hearsay-tools/cezarion#1147). A line ends at LF or CRLF: an agent or an editor can save the
+ *  file with CRLF endings. */
+export declare function exactLineIndex(text: string, line: string): number;
+/** Index just past the line that starts at `index`: after its LF or CRLF, or the end of `text`. */
+export declare function nextLineIndex(text: string, index: number): number;

package/dist/contract/health.d.ts

@@ -42,10 +42,10 @@ export type ForgeInfo = z.infer<typeof forgeInfoSchema>;
 /** Server-side feature switches the cockpit reads once at boot. */
 export declare const capabilitiesSchema: z.ZodObject<{
     localHandoff: z.ZodBoolean;
-    followups: z.ZodBoolean;
     singleProject: z.ZodBoolean;
     automations: z.ZodBoolean;
     preview: z.ZodBoolean;
+    voice: z.ZodBoolean;
     tokenMetrics: z.ZodBoolean;
     tokenUsageMetrics: z.ZodBoolean;
     costMetrics: z.ZodBoolean;
@@ -95,10 +95,10 @@ export declare const healthResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     capabilities: z.ZodObject<{
         localHandoff: z.ZodBoolean;
-        followups: z.ZodBoolean;
         singleProject: z.ZodBoolean;
         automations: z.ZodBoolean;
         preview: z.ZodBoolean;
+        voice: z.ZodBoolean;
         tokenMetrics: z.ZodBoolean;
         tokenUsageMetrics: z.ZodBoolean;
         costMetrics: z.ZodBoolean;

package/dist/contract/image-path.d.ts

@@ -0,0 +1,6 @@
+/** The image MIME type for a path, or null when it is not an image we serve raw. */
+export declare function imageMimeType(path: string): string | null;
+/** True when `path` is an image safe to hand to the OS's default handler — see OS_OPENABLE_EXT. */
+export declare function isOsOpenableImage(path: string): boolean;
+/** Images the browser can preview, including SVG under the raw route's protections. */
+export declare function isImagePath(path: string): boolean;

package/dist/contract/index.d.ts

@@ -4,15 +4,20 @@
  */
 export * from './events.ts';
 export * from './ask.ts';
+export * from './pending-ask.ts';
 export * from './delegation.ts';
 export * from './effort.ts';
 export * from './health.ts';
 export * from './application-update.ts';
 export * from './runs.ts';
+export * from './run-labels.ts';
+export * from './run-limits.ts';
+export * from './attachments.ts';
 export * from './attention.ts';
 export * from './repo.ts';
 export * from './github.ts';
 export * from './projects.ts';
+export * from './project-limits.ts';
 export * from './workspace.ts';
 export * from './workflows.ts';
 export * from './skills.ts';
@@ -21,8 +26,34 @@ export * from './agent-profiles.ts';
 export * from './zoned-time.ts';
 export * from './automation-schedule.ts';
 export * from './automations.ts';
+export * from './scheduled-tasks.ts';
 export * from './preview.ts';
+export * from './voice.ts';
 export * from './conversations.ts';
 export * from './ci-wait.ts';
+export * from './waits.ts';
+export * from './run-predicates.ts';
+export * from './handoff.ts';
+export * from './run-search.ts';
 export * from './artifacts.ts';
 export * from './discovery.ts';
+export * from './live.ts';
+export * from './live-limits.ts';
+export * from './live-coordination.ts';
+export * from './permissions.ts';
+export * from './defined.ts';
+export * from './tool-display.ts';
+export * from './version.ts';
+export * from './active-provider.ts';
+export * from './image-path.ts';
+export * from './provider-requests.ts';
+export * from './automation-requests.ts';
+export * from './workflow-requests.ts';
+export * from './ui-state-requests.ts';
+export * from './run-requests.ts';
+export * from './query-requests.ts';
+export * from './github-requests.ts';
+export * from './repo-requests.ts';
+export * from './config-requests.ts';
+export * from './workflow-file.ts';
+export * from './automation-storage.ts';