@coltonkirsten/a12s 0.4.0 → 0.4.1

package/dist/a12s.js

@@ -469,6 +469,7 @@ function agentComputerOf(ev) {
 function wanted(names, ev) {
   if (!names) return true;
   if (ev.type === "fleet.changed") return (ev.data?.names ?? []).some((n) => names.has(n));
+  if (ev.type === "service.phase") return names.has(ev.data?.service);
   return names.has(agentComputerOf(ev));
 }
 var EventStream = class {

package/dist/src/client.js

@@ -492,6 +492,8 @@ function wanted(names, ev) {
         return true;
     if (ev.type === "fleet.changed")
         return (ev.data?.names ?? []).some((n) => names.has(n));
+    if (ev.type === "service.phase")
+        return names.has(ev.data?.service);
     return names.has(agentComputerOf(ev));
 }
 /** Events of one or more Computers, merged in arrival order. Iterate it with `for await`. */

package/dist/src/types.d.ts

@@ -92,6 +92,14 @@ export interface Change {
     when: "now" | "idle" | (string & {});
     /** The top-level spec fields that differ, for an update. */
     fields?: string[];
+    /** Every leaf that differs, for an update, with its value before and after (absent where the field is). */
+    diff?: FieldDiff[];
+}
+/** One leaf of a spec that differs: `path` is dotted field names ("grants.send"); lists and values are leaves. */
+export interface FieldDiff {
+    path: string;
+    before?: unknown;
+    after?: unknown;
 }
 export interface FleetResponse {
     version: number;
@@ -398,6 +406,15 @@ export interface PhaseData {
     phase: Phase;
     error?: Failure;
 }
+/** A Service's phase, health or restart count changed. */
+export interface ServicePhaseData {
+    service: string;
+    phase: Phase;
+    /** "ok", or why the last health check failed. */
+    health?: string;
+    restarts: number;
+    error?: Failure;
+}
 export interface ToolStartedData {
     id: string;
     /** MCP tools are named `mcp__<server>__<tool>`, e.g. `mcp__a12s__send`. */
@@ -468,10 +485,14 @@ export type EgressDeniedEvent = Ev<"egress.denied", EgressDeniedData>;
 export type FleetChangedEvent = Ev<"fleet.changed", FleetChangedData>;
 /** Made by the Controller, on the fleet-wide stream only. */
 export type PhaseEvent = Ev<"agent_computer.phase", PhaseData>;
+/** Made by the Controller, on the fleet-wide stream only, after any change to the agent computer's inbox (a burst is one event). */
+export type InboxChangedEvent = Ev<"inbox.changed", InboxSummary>;
+/** Made by the Controller, on the fleet-wide stream only; `agentComputer` is empty, the Service is in `data`. */
+export type ServicePhaseEvent = Ev<"service.phase", ServicePhaseData>;
 /** Made by the SDK, never journaled: the stream could not resume from its cursor and events were lost. */
 export type GapEvent = Ev<"gap", GapData>;
 /** One event of an agent computer's journal, or the Controller's own on the fleet-wide stream. Narrow on `type` to get typed `data`. */
-export type A12sEvent = TurnStartedEvent | TurnDispatchedEvent | TextDeltaEvent | ToolStartedEvent | ToolFinishedEvent | PermissionEvent | DiagnosticEvent | TurnFinishedEvent | SessionChangedEvent | ResumeFailedEvent | LifecycleEvent | HarnessRestartedEvent | ContinuationAbandonedEvent | TurnRefusedEvent | InboxDiscardedEvent | EgressDeniedEvent | FleetChangedEvent | PhaseEvent | GapEvent;
+export type A12sEvent = TurnStartedEvent | TurnDispatchedEvent | TextDeltaEvent | ToolStartedEvent | ToolFinishedEvent | PermissionEvent | DiagnosticEvent | TurnFinishedEvent | SessionChangedEvent | ResumeFailedEvent | LifecycleEvent | HarnessRestartedEvent | ContinuationAbandonedEvent | TurnRefusedEvent | InboxDiscardedEvent | EgressDeniedEvent | FleetChangedEvent | PhaseEvent | InboxChangedEvent | ServicePhaseEvent | GapEvent;
 export type EventType = A12sEvent["type"];
 /** One tool call in a Turn. A `send` to another Computer is `mcp__a12s__send` with `input.body`. */
 export interface ToolCall {
@@ -530,6 +551,8 @@ export interface CredentialInfo {
     name: string;
     set: boolean;
     usedBy?: string[];
+    /** When the value last changed (RFC 3339); absent if unknown. */
+    updatedAt?: string;
 }
 export interface CredentialsResponse {
     credentials: CredentialInfo[];
@@ -540,6 +563,8 @@ export interface Token {
     computers: string[];
     prefix?: string;
     createdAt: string;
+    /** When it last authenticated (RFC 3339, recorded at most once a minute); absent if never. */
+    lastUsedAt?: string;
     secret?: string;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coltonkirsten/a12s",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "TypeScript client for a12s: send work to agent Computers, stream their events and Turns, in Node or the browser",
   "license": "MIT",
   "type": "module",