wicked-core-ts 0.2.1 → 0.4.0

package/index.d.ts

@@ -62,6 +62,39 @@ export declare class Core {
   subscribe(callback: (err: Error | null, eventJson: string) => void): Subscription
   /** Liveness probe — emits a `Heartbeat` to subscribers and resolves once the actor acks (`"ok"`). */
   ping(): Promise<string>
+  /**
+   * Open a chat: eagerly warm one ACP session per seat (crew#165 / core#13). Resolves to a
+   * JSON array of per-seat outcomes `[{cliKey, ok, error?}]`; `chatSessionReady`/`chatSessionFailed`
+   * also stream to subscribers. Blocking handshakes run on the task pool, not the JS thread.
+   */
+  chatOpen(chatId: string, clisJson: string, cwd?: string | undefined | null): Promise<string>
+  /**
+   * Fan a message out to the chat's warm seats (all, or `targets_json` subset). Ack-fast:
+   * resolves to the JSON array of seats targeted; replies stream as `chatDelta`/`chatReply`.
+   */
+  chatSend(chatId: string, text: string, targetsJson?: string | undefined | null, cwd?: string | undefined | null): Promise<string>
+  /** The seats currently warm for a chat — JSON array of cli keys. */
+  chatSeats(chatId: string): Promise<string>
+  /**
+   * Every chat currently holding pool state — JSON array of
+   * `[{chatId, seats, idleSecs}]`, sorted by id.
+   *
+   * Each warm seat pins an ACP bridge plus an agent child (~520 MB resident) and clients mint
+   * chat ids freely, so without this an accumulation is invisible until the host runs out of
+   * memory (FINDING-027). `idleSecs` is seconds since the chat's last open/ensure/turn, or
+   * `null` when no activity was ever recorded — which the reaper treats as idle-since-forever.
+   *
+   * `null` rather than the `u64::MAX` the Rust side uses for that case: a JS `number` is an
+   * f64, so `u64::MAX` arrives as `18446744073709552000` and no consumer can test for the
+   * sentinel by equality. `null` is checkable, and it stops a caller from doing arithmetic on a
+   * value that never meant a duration.
+   */
+  chatList(): Promise<string>
+  /**
+   * Close a chat's warm sessions (idempotent); emits
+   * `chatClosed` with `reason: "requested"`.
+   */
+  chatClose(chatId: string): Promise<string>
   /**
    * Launch an interactive, resumable run: plans + distributes, then executes each unit off-thread
    * (or pauses at a human-confirm gate). Resolves to the run id. Progress arrives as `CoreEvent`s
@@ -93,6 +126,21 @@ export declare class Core {
   sessionsDetail(): Promise<string>
   /** A unit's captured work output (transcript), as a JSON value — a string, or `null` if none. */
   workOutput(unitId: string): Promise<string>
+  /**
+   * A run's recorded event history, oldest first, as a JSON array. Each entry is the SAME tagged
+   * object the `/ws` stream carries ([`CoreEvent::to_json`]) plus a capture-time `ts` (epoch millis)
+   * and an ordering `seq`.
+   *
+   * The read half of FINDING-014: an evidence bundle assembled after a run must read what actually
+   * happened rather than re-derive pseudo-events from unit records, which cannot recover what it
+   * never saw and invents its own type names doing it. Because the log and the socket serialize
+   * through one mapping, an event named here is the event named live.
+   *
+   * Empty array for an unknown run, one that emitted nothing, or one predating the log — an absent
+   * history is not an error. Streaming chunk events (`cliOutputDelta`, `chatDelta`,
+   * `terminalOutput`, `heartbeat`) are excluded by design.
+   */
+  runEvents(runId: string): Promise<string>
   /**
    * Register a git repository the orchestrator can run within. Validates it is a git repo with
    * ≥1 commit; resolves to the persisted `RepoEntry` as a JSON object.
@@ -119,6 +167,26 @@ export declare class Core {
    * Validates server-side (INV-C1/C2/C4). Idempotent on stable id.
    */
   upsertConformanceRule(ruleJson: string): Promise<string>
+  /**
+   * Withdraw a governance policy from enforcement (FINDING-038 — governance state was otherwise
+   * append-only, so a mis-authored policy denied forever).
+   *
+   * Retire, not delete: the node stays readable so a past decision citing this id can still be
+   * explained, but SELECT stops returning it, so it can never decide another gate.
+   *
+   * Resolves to a JSON-encoded boolean: the four characters `true` if a policy with that id
+   * existed, the five characters `false` if none did. Like every method here it hands JS a
+   * `Promise<string>` carrying JSON, so it must be `JSON.parse`d — a bare truthiness test
+   * passes on BOTH values and would read a miss as a hit, losing exactly the 200-vs-404
+   * distinction this return value exists to carry.
+   */
+  retirePolicy(id: string): Promise<string>
+  /**
+   * Withdraw a conformance rule from recall. Same retire-not-delete contract as
+   * [`Core::retire_policy`], and the same JSON-encoded `true`/`false` reply that must be
+   * parsed rather than tested for truthiness.
+   */
+  retireConformanceRule(id: string): Promise<string>
   /**
    * Register (or replace) a workflow definition in the actor's runtime registry. `json` is a
    * JSON-serialised `WorkflowDef` object (fields: id, description, phases — see the wicked-core

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-core-ts",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Node/TypeScript bindings (napi-rs) for wicked-core: drive the in-process orchestration engine from JS/TS.",
   "license": "MIT",
   "repository": {
@@ -41,11 +41,11 @@
     "smoke:all": "node smoke.mjs && node smoke-lifecycle.mjs && node smoke-terminal.mjs"
   },
   "optionalDependencies": {
-    "wicked-core-ts-darwin-arm64": "0.2.1",
-    "wicked-core-ts-darwin-x64": "0.2.1",
-    "wicked-core-ts-linux-arm64-gnu": "0.2.1",
-    "wicked-core-ts-linux-x64-gnu": "0.2.1",
-    "wicked-core-ts-win32-x64-msvc": "0.2.1"
+    "wicked-core-ts-darwin-arm64": "0.4.0",
+    "wicked-core-ts-darwin-x64": "0.4.0",
+    "wicked-core-ts-linux-arm64-gnu": "0.4.0",
+    "wicked-core-ts-linux-x64-gnu": "0.4.0",
+    "wicked-core-ts-win32-x64-msvc": "0.4.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.4"