wicked-crew-api-types 0.6.0 → 0.8.0

package/index.d.ts

@@ -161,6 +161,23 @@ export interface AgentSession {
   archived_at: number | null;
   /** Optional operator note recorded at archival. */
   archive_note: string | null;
+  /**
+   * The project this run is filed into (DES-UX-001 §8.2, CREW-UX-2; api-types 0.8.0) —
+   * populated by the crew server from the membership record at DTO assembly on BOTH
+   * `GET /runs` and `GET /runs/:id`, so clients no longer re-derive the run→project join.
+   *
+   * `null` = genuinely unfiled (the synthesized `default` project); ABSENT = a pre-0.8.0
+   * server that never joins. Read with `== null` only if "unfiled" and "old server" may
+   * collapse for your surface; a project chip should render only on `typeof === 'string'`.
+   */
+  project_id?: string | null;
+  /**
+   * Retry lineage (DES-UX-001 §8.3, CREW-UX-3; api-types 0.8.0): the id of the run this run
+   * was launched as a retry of (`LaunchRunBody.retryOf`, validated at launch to name an
+   * existing run). ABSENT — never `null` — when the run is not a retry: absence is the one
+   * spelling of "no lineage", so `'retry_of' in session` and `!== undefined` agree.
+   */
+  retry_of?: string;
 }
 
 /** An ordered unit of work within a run (`WorkUnit`). */
@@ -288,6 +305,39 @@ export interface OpenPathBody {
   runId?: string;
 }
 
+/**
+ * Response of `GET /runs/:id/files?path=<abs>` (DES-FEEDBACK-002 CREW-1) — a capped, read-only
+ * file read contained against the SAME root set `POST /open` validates (run workdir + extra
+ * write roots + registered repo roots). 404 unknown run / missing file; 400 non-absolute path;
+ * 403 outside every allowed root (fail-closed, symlink-safe).
+ */
+export interface RunFileContent {
+  /** The resolved absolute path that was served. */
+  path: string;
+  /** UTF-8 file text — the first 512 KB when `truncated`, `""` when `binary`. */
+  content: string;
+  /** The file's FULL size in bytes (not the served slice's). */
+  size: number;
+  /** The file exceeds the 512 KB cap and `content` holds only the first 512 KB. */
+  truncated: boolean;
+  /** NUL byte in the first 8 KB — render "binary file · open externally", never the content. */
+  binary: boolean;
+}
+
+/**
+ * Response of `GET /runs/:id/diff` / `GET /runs/:id/diff?path=<abs>` (DES-FEEDBACK-002 CREW-1) —
+ * the run worktree's unified diff against HEAD (staged + unstaged), with untracked files appended
+ * as all-addition `--no-index` hunks. `diff: ""` = clean tree (a real answer, not an error).
+ * 404 unknown run; 409 when the run has no workdir or it no longer exists; with `path`, the same
+ * 400/403 containment as `RunFileContent`.
+ */
+export interface RunDiff {
+  /** Unified diff text (`git diff --no-color --no-ext-diff HEAD`), cut at 1 MB when `truncated`. */
+  diff: string;
+  /** The diff exceeded the 1 MB output cap and was cut. */
+  truncated: boolean;
+}
+
 /** The daemon's cached open-gate record (`GET /runs/:id/gate`, DES-STUDIO-001 §3.3). */
 export interface GateInfo {
   runId: string;
@@ -886,6 +936,27 @@ export interface LaunchRunBody {
    * (4xx) — never a silent unfiled run. Omit for an unfiled run (the synthesized `default`).
    */
   projectId?: string;
+  /**
+   * Delivery mode (crew#293). `"pr"` ⇒ the daemon appends a hardened deliver Tool phase (push
+   * the run's branch, rebase onto origin's default branch, `gh pr create`; the PR URL is the
+   * phase output's last line) to a PER-RUN copy of the selected workflow def — the shared def
+   * is never mutated, and merge stays human. Requires `workflow`; sending `deliver` without it
+   * is a 400. Omit ⇒ no delivery phase.
+   *
+   * NOTE for the next api-types release: added daemon-side first (workspace copy, 0.6.0 +
+   * crew#293) — fold into the published `LaunchRunBody` when 0.7.0 cuts. Optional, so the
+   * field is forward-additive on the wire (DES-STUDIO-001 §5.1).
+   */
+  deliver?: 'pr';
+  /**
+   * Retry lineage (DES-UX-001 §8.3, CREW-UX-3; api-types 0.8.0): the id of the run this
+   * launch retries. Must name an EXISTING run id — an unknown id fails the launch (400 with
+   * a named error), never a silently unrecorded lineage. The daemon persists it, echoes it
+   * as `AgentSession.retry_of`, and carries it in the `run.launched` audit entry's detail,
+   * so provenance renders "retry of {id}" from the system of record, not prompt equality.
+   * Omit when the launch is not a retry.
+   */
+  retryOf?: string;
 }
 
 // ── Governance types (crew#40/41) ──────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames \u2014 types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",