@pennixrv/trellis-core 0.7.0-beta.8 → 0.7.1

package/dist/teamwork/api/resolve.js

@@ -0,0 +1,28 @@
+import { sessionDir, resolveTeamworkSessionProjectForCreate, resolveExistingTeamworkSession, } from "../internal/store/paths.js";
+/**
+ * Resolve a `TeamworkSessionRef` honoring `--scope`, an explicit `projectKey`,
+ * or cwd-derived defaults. Mirrors the CLI's scope-resolution rules so
+ * downstream consumers behave the same way.
+ */
+export function resolveTeamworkSession(opts) {
+    if (opts.projectKey) {
+        const project = opts.projectKey;
+        return {
+            name: opts.sessionId,
+            scope: opts.scope ?? "project",
+            project,
+            dir: sessionDir(opts.sessionId, project),
+        };
+    }
+    if (opts.forCreate) {
+        return resolveTeamworkSessionProjectForCreate(opts.sessionId, {
+            scope: opts.scope,
+            cwd: opts.cwd,
+        });
+    }
+    return resolveExistingTeamworkSession(opts.sessionId, {
+        scope: opts.scope,
+        cwd: opts.cwd,
+    });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/teamwork/api/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/teamwork/api/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,sCAAsC,EACtC,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAoBpC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAmC;IACxE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;YAC9B,OAAO;YACP,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;SACzC,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,sCAAsC,CAAC,IAAI,CAAC,SAAS,EAAE;YAC5D,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,8BAA8B,CAAC,IAAI,CAAC,SAAS,EAAE;QACpD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/{channel → teamwork}/api/runtime.d.ts

@@ -8,9 +8,9 @@
  * {@link interruptWorker}.
  */
 import type { InterruptMethod, InterruptOutcome, InterruptReason } from "../internal/store/events.js";
-import type { ChannelRef, ChannelScope, InboxPolicy } from "../internal/store/schema.js";
+import type { TeamworkSessionRef, TeamworkSessionScope, InboxPolicy } from "../internal/store/schema.js";
 export interface WorkerStartInput {
-    channel: ChannelRef;
+    sessionId: TeamworkSessionRef;
     workerId: string;
     cwd: string;
     systemPrompt: string;
@@ -52,8 +52,8 @@ export interface WorkerRuntime {
     stop?(input: WorkerStopInput): Promise<WorkerStopResult>;
 }
 export interface SpawnWorkerInput {
-    channel: string;
-    scope?: ChannelScope;
+    sessionId: string;
+    scope?: TeamworkSessionScope;
     projectKey?: string;
     cwd: string;
     by: string;

package/dist/teamwork/api/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7D,SAAS,CAAC,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/teamwork/api/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/teamwork/api/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/teamwork/api/send.d.ts

@@ -0,0 +1,4 @@
+import { type MessageTeamworkEvent } from "../internal/store/events.js";
+import type { SendMessageOptions } from "./types.js";
+export declare function sendMessage(opts: SendMessageOptions): Promise<MessageTeamworkEvent>;
+//# sourceMappingURL=send.d.ts.map

package/dist/teamwork/api/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAwD/B"}

package/dist/{channel → teamwork}/api/send.js

@@ -1,15 +1,15 @@
-import { appendEvent, readChannelEvents, } from "../internal/store/events.js";
+import { appendEvent, readTeamworkEvents, } from "../internal/store/events.js";
 import { classifyDelivery } from "../internal/store/delivery.js";
 import { reduceWorkerRegistry } from "../internal/store/worker-state.js";
-import { resolveChannelRef } from "./resolve.js";
+import { resolveTeamworkSession } from "./resolve.js";
 export async function sendMessage(opts) {
-    const ref = resolveChannelRef({
-        channel: opts.channel,
+    const ref = resolveTeamworkSession({
+        sessionId: opts.sessionId,
         ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
         ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
         ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
     });
-    const event = (await appendEvent(opts.channel, {
+    const event = (await appendEvent(opts.sessionId, {
         kind: "message",
         by: opts.by,
         ...(opts.idempotencyKey !== undefined
@@ -27,11 +27,11 @@ export async function sendMessage(opts) {
     const mode = opts.deliveryMode ?? "appendOnly";
     if (mode !== "appendOnly" && event.to !== undefined) {
         const targets = Array.isArray(event.to) ? event.to : [event.to];
-        const events = await readChannelEvents(opts.channel, ref.project);
+        const events = await readTeamworkEvents(opts.sessionId, ref.project);
         const registry = reduceWorkerRegistry(events);
         const failures = classifyDelivery(registry, targets, mode);
         for (const failure of failures) {
-            await appendEvent(opts.channel, {
+            await appendEvent(opts.sessionId, {
                 kind: "undeliverable",
                 by: opts.by,
                 ...(opts.idempotencyKey !== undefined

package/dist/teamwork/api/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/teamwork/api/send.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,GAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAwB;IAExB,MAAM,GAAG,GAAG,sBAAsB,CAAC;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,CAAC,MAAM,WAAW,CAC9B,IAAI,CAAC,SAAS,EACd;QACE,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,EACD,GAAG,CAAC,OAAO,CACZ,CAAyB,CAAC;IAE3B,qEAAqE;IACrE,sEAAsE;IACtE,sEAAsE;IACtE,8DAA8D;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC;IAC/C,IAAI,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,WAAW,CACf,IAAI,CAAC,SAAS,EACd;gBACE,IAAI,EAAE,eAAe;gBACrB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;oBACnC,CAAC,CAAC;wBACE,cAAc,EAAE,GAAG,IAAI,CAAC,cAAc,kBAAkB,OAAO,CAAC,YAAY,EAAE;qBAC/E;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,EACD,GAAG,CAAC,OAAO,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/{channel → teamwork}/api/spawn.d.ts

@@ -3,7 +3,7 @@ import type { SpawnWorkerInput, WorkerRuntime } from "./runtime.js";
 /**
  * Spawn a worker through a provider-injected runtime.
  *
- * Core resolves the channel, asks the injected runtime to start the
+ * Core resolves the Teamwork Session, asks the injected runtime to start the
  * worker process, appends the durable `spawned` event (with runtime
  * metadata and the selected inbox policy), and returns the projected
  * {@link WorkerState}. The runtime owns process launch details; core

package/dist/teamwork/api/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/spawn.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEd,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC,CAkDtB"}

package/dist/teamwork/api/spawn.js

@@ -0,0 +1,54 @@
+import { appendEvent, readTeamworkEvents, } from "../internal/store/events.js";
+import { DEFAULT_INBOX_POLICY } from "../internal/store/inbox.js";
+import { reduceWorkerRegistry, } from "../internal/store/worker-state.js";
+import { resolveTeamworkSession } from "./resolve.js";
+/**
+ * Spawn a worker through a provider-injected runtime.
+ *
+ * Core resolves the Teamwork Session, asks the injected runtime to start the
+ * worker process, appends the durable `spawned` event (with runtime
+ * metadata and the selected inbox policy), and returns the projected
+ * {@link WorkerState}. The runtime owns process launch details; core
+ * owns event writes and state projection.
+ */
+export async function spawnWorker(input, runtime) {
+    const ref = resolveTeamworkSession({
+        sessionId: input.sessionId,
+        ...(input.scope !== undefined ? { scope: input.scope } : {}),
+        ...(input.projectKey !== undefined
+            ? { projectKey: input.projectKey }
+            : {}),
+        ...(input.cwd !== undefined ? { cwd: input.cwd } : {}),
+    });
+    const startInput = {
+        sessionId: ref,
+        workerId: input.workerId,
+        cwd: input.cwd,
+        systemPrompt: input.systemPrompt,
+        ...(input.model !== undefined ? { model: input.model } : {}),
+        ...(input.resume !== undefined ? { resume: input.resume } : {}),
+    };
+    const handle = await runtime.start(startInput);
+    const inboxPolicy = input.inboxPolicy ?? DEFAULT_INBOX_POLICY;
+    await appendEvent(input.sessionId, {
+        kind: "spawned",
+        by: input.by,
+        as: input.workerId,
+        inboxPolicy,
+        ...(input.provider ?? handle.provider
+            ? { provider: input.provider ?? handle.provider }
+            : {}),
+        ...(handle.pid !== undefined ? { pid: handle.pid } : {}),
+        ...(input.agent !== undefined ? { agent: input.agent } : {}),
+        ...(input.meta !== undefined ? { meta: input.meta } : {}),
+    }, ref.project);
+    const events = await readTeamworkEvents(input.sessionId, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const state = registry.workers.find((w) => w.workerId === input.workerId);
+    if (!state) {
+        // Should never happen — we just appended the spawned event.
+        throw new Error(`spawnWorker: worker '${input.workerId}' missing from registry after spawn`);
+    }
+    return state;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/teamwork/api/spawn.js.map

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

package/dist/teamwork/api/title.d.ts

@@ -0,0 +1,5 @@
+import { type TeamworkMetadataEvent } from "../internal/store/events.js";
+import type { ClearTeamworkSessionTitleOptions, SetTeamworkSessionTitleOptions } from "./types.js";
+export declare function setTeamworkSessionTitle(opts: SetTeamworkSessionTitleOptions): Promise<TeamworkMetadataEvent>;
+export declare function clearTeamworkSessionTitle(opts: ClearTeamworkSessionTitleOptions): Promise<TeamworkMetadataEvent>;
+//# sourceMappingURL=title.d.ts.map

package/dist/teamwork/api/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/title.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EACV,gCAAgC,EAChC,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,qBAAqB,CAAC,CAoBhC"}

package/dist/{channel → teamwork}/api/title.js

@@ -1,17 +1,17 @@
 import { appendEvent, } from "../internal/store/events.js";
-import { resolveChannelRef } from "./resolve.js";
-export async function setChannelTitle(opts) {
+import { resolveTeamworkSession } from "./resolve.js";
+export async function setTeamworkSessionTitle(opts) {
     if (!opts.title || opts.title.length === 0) {
-        throw new Error("Channel title must not be empty (use clearChannelTitle)");
+        throw new Error("Teamwork Session title must not be empty (use clearTeamworkSessionTitle)");
     }
-    const ref = resolveChannelRef({
-        channel: opts.channel,
+    const ref = resolveTeamworkSession({
+        sessionId: opts.sessionId,
         ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
         ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
         ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
     });
-    const event = await appendEvent(opts.channel, {
-        kind: "channel",
+    const event = await appendEvent(opts.sessionId, {
+        kind: "teamwork",
         action: "title",
         by: opts.by,
         title: opts.title,
@@ -20,15 +20,15 @@ export async function setChannelTitle(opts) {
     }, ref.project);
     return event;
 }
-export async function clearChannelTitle(opts) {
-    const ref = resolveChannelRef({
-        channel: opts.channel,
+export async function clearTeamworkSessionTitle(opts) {
+    const ref = resolveTeamworkSession({
+        sessionId: opts.sessionId,
         ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
         ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
         ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
     });
-    const event = await appendEvent(opts.channel, {
-        kind: "channel",
+    const event = await appendEvent(opts.sessionId, {
+        kind: "teamwork",
         action: "title",
         by: opts.by,
         title: null,

package/dist/teamwork/api/title.js.map

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

package/dist/{channel → teamwork}/api/types.d.ts

@@ -1,8 +1,8 @@
 import type { DeliveryMode } from "../internal/store/delivery.js";
-import type { ChannelScope, ContextEntry, EventOrigin } from "../internal/store/schema.js";
-export interface ChannelAddressOptions {
-    channel: string;
-    scope?: ChannelScope;
+import type { TeamworkSessionScope, ContextEntry, EventOrigin } from "../internal/store/schema.js";
+export interface TeamworkSessionAddressOptions {
+    sessionId: string;
+    scope?: TeamworkSessionScope;
     /** Storage project bucket key. Not the create-event `project` slug. */
     projectKey?: string;
     /** cwd used to derive the project bucket when scope is "project". */
@@ -13,7 +13,7 @@ export interface MutationCommonOptions {
     origin?: EventOrigin;
     meta?: Record<string, unknown>;
 }
-export interface CreateChannelOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface CreateTeamworkSessionOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     type?: "chat" | "forum";
     task?: string;
     project?: string;
@@ -21,11 +21,9 @@ export interface CreateChannelOptions extends ChannelAddressOptions, MutationCom
     description?: string;
     context?: ContextEntry[];
     ephemeral?: boolean;
-    /** Opaque main Codex session identity for read-only observability. */
-    ownerSessionId?: string;
     force?: boolean;
 }
-export interface SendMessageOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface SendMessageOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     idempotencyKey?: string;
     text: string;
     to?: string | string[];
@@ -37,7 +35,7 @@ export interface SendMessageOptions extends ChannelAddressOptions, MutationCommo
      */
     deliveryMode?: DeliveryMode;
 }
-export interface PostThreadOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface PostThreadOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     idempotencyKey?: string;
     action: "opened" | "comment" | "status" | "labels" | "assignees" | "summary" | "processed";
     thread: string;
@@ -50,18 +48,18 @@ export interface PostThreadOptions extends ChannelAddressOptions, MutationCommon
     summary?: string;
     context?: ContextEntry[];
 }
-export interface ContextMutationOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface ContextMutationOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     context: ContextEntry[];
 }
 export interface ThreadContextMutationOptions extends ContextMutationOptions {
     thread: string;
 }
-export interface RenameThreadOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface RenameThreadOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     thread: string;
     newThread: string;
 }
-export interface SetChannelTitleOptions extends ChannelAddressOptions, MutationCommonOptions {
+export interface SetTeamworkSessionTitleOptions extends TeamworkSessionAddressOptions, MutationCommonOptions {
     title: string;
 }
-export type ClearChannelTitleOptions = ChannelAddressOptions & MutationCommonOptions;
+export type ClearTeamworkSessionTitleOptions = TeamworkSessionAddressOptions & MutationCommonOptions;
 //# sourceMappingURL=types.d.ts.map

package/dist/teamwork/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,4BACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CAEjB;AAED,MAAM,WAAW,kBACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,iBACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EACF,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,GACT,WAAW,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BACf,SAAQ,6BAA6B,EACnC,qBAAqB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAC1E,qBAAqB,CAAC"}

package/dist/{channel → teamwork}/api/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channel/api/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/teamwork/api/types.ts"],"names":[],"mappings":""}

package/dist/teamwork/api/watch-sessions.d.ts

@@ -0,0 +1,40 @@
+import type { TeamworkEvent } from "../internal/store/events.js";
+import type { TeamworkEventFilter } from "../internal/store/filter.js";
+import { type TeamworkSessionRef } from "../internal/store/schema.js";
+/** Stable per-session cursor key: `${scope}/${project}/${name}`. */
+export type TeamworkSessionCursorKey = string;
+/** Per-session resume cursor for the cross-session watcher. */
+export type TeamworkSessionCursor = Record<TeamworkSessionCursorKey, number>;
+export declare function teamworkSessionCursorKey(ref: TeamworkSessionRef): TeamworkSessionCursorKey;
+export interface WatchTeamworkSessionsInput {
+    /** Project bucket scope, or the global bucket. */
+    scope: {
+        projectKey: string;
+    } | "global";
+    filter?: TeamworkEventFilter;
+    /** Per-session resume cursors keyed by {@link teamworkSessionCursorKey}. */
+    cursor?: TeamworkSessionCursor;
+    signal?: AbortSignal;
+    /**
+     * When a Teamwork Session is discovered after the watcher starts, read its
+     * backlog from seq 0. Default false (tail from end).
+     */
+    fromStartNewTeamworkSessions?: boolean;
+    /** TeamworkSession-discovery poll interval in ms. Default 500. */
+    discoveryIntervalMs?: number;
+}
+export interface CrossTeamworkEvent {
+    sessionId: TeamworkSessionRef;
+    event: TeamworkEvent;
+    /** Snapshot of the full cursor map after applying this event. */
+    cursor: TeamworkSessionCursor;
+}
+/**
+ * Watch every Teamwork Session in a project (or the global) scope and fan its
+ * events into a single stream. Sessions created inside the scope after
+ * the watcher starts are discovered dynamically. Each yielded event
+ * carries a snapshot of the per-session cursor map so consumers can
+ * checkpoint `(session ID, seq)` — delivery is at-least-once.
+ */
+export declare function watchTeamworkSessions(input: WatchTeamworkSessionsInput): AsyncGenerator<CrossTeamworkEvent, void, unknown>;
+//# sourceMappingURL=watch-sessions.d.ts.map

package/dist/teamwork/api/watch-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-sessions.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/watch-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAKvE,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,6BAA6B,CAAC;AAGrC,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE9C,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;AAE7E,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,wBAAwB,CAE1F;AAED,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,iEAAiE;IACjE,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAYD;;;;;;GAMG;AACH,wBAAuB,qBAAqB,CAC1C,KAAK,EAAE,0BAA0B,GAChC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,CAgInD"}

package/dist/{channel/api/watch-channels.js → teamwork/api/watch-sessions.js}

@@ -1,7 +1,7 @@
-import { channelDir, listChannelNamesInProject, } from "../internal/store/paths.js";
+import { sessionDir, listSessionIdsInProject, } from "../internal/store/paths.js";
 import { GLOBAL_PROJECT_KEY, } from "../internal/store/schema.js";
 import { watchEvents } from "../internal/store/watch.js";
-export function channelCursorKey(ref) {
+export function teamworkSessionCursorKey(ref) {
     return `${ref.scope}/${ref.project}/${ref.name}`;
 }
 function resolveScope(input) {
@@ -11,13 +11,13 @@ function resolveScope(input) {
     return { project: input.scope.projectKey, scope: "project" };
 }
 /**
- * Watch every channel in a project (or the global) scope and fan their
- * events into a single stream. Channels created inside the scope after
+ * Watch every Teamwork Session in a project (or the global) scope and fan its
+ * events into a single stream. Sessions created inside the scope after
  * the watcher starts are discovered dynamically. Each yielded event
- * carries a snapshot of the per-channel cursor map so consumers can
- * checkpoint `(channel, seq)` — delivery is at-least-once.
+ * carries a snapshot of the per-session cursor map so consumers can
+ * checkpoint `(session ID, seq)` — delivery is at-least-once.
  */
-export async function* watchChannels(input) {
+export async function* watchTeamworkSessions(input) {
     const { project, scope } = resolveScope(input);
     const filter = input.filter ?? {};
     const discoveryIntervalMs = input.discoveryIntervalMs ?? 500;
@@ -63,9 +63,9 @@ export async function* watchChannels(input) {
             name,
             scope,
             project,
-            dir: channelDir(name, project),
+            dir: sessionDir(name, project),
         };
-        const key = channelCursorKey(ref);
+        const key = teamworkSessionCursorKey(ref);
         if (active.has(key))
             return;
         active.add(key);
@@ -78,17 +78,17 @@ export async function* watchChannels(input) {
             watchOpts.sinceSeq = resume;
         }
         else {
-            // No prior cursor: initial channels read their backlog; channels
-            // discovered later follow `fromStartNewChannels`.
+            // No prior cursor: newly discovered sessions read their backlog; sessions
+            // discovered later follow `fromStartNewTeamworkSessions`.
             watchOpts.fromStart = initialScan
                 ? true
-                : (input.fromStartNewChannels ?? false);
+                : (input.fromStartNewTeamworkSessions ?? false);
         }
         const task = (async () => {
             try {
                 for await (const ev of watchEvents(name, filter, watchOpts)) {
                     cursor[key] = ev.seq;
-                    queue.push({ channel: ref, event: ev, cursor: { ...cursor } });
+                    queue.push({ sessionId: ref, event: ev, cursor: { ...cursor } });
                     notify();
                 }
             }
@@ -106,14 +106,14 @@ export async function* watchChannels(input) {
             tasks.delete(task);
         });
     };
-    for (const name of listChannelNamesInProject(project)) {
+    for (const name of listSessionIdsInProject(project)) {
         startWatcher(name);
     }
     initialScan = false;
     discovery = setInterval(() => {
         if (done)
             return;
-        for (const name of listChannelNamesInProject(project)) {
+        for (const name of listSessionIdsInProject(project)) {
             startWatcher(name);
         }
     }, discoveryIntervalMs);
@@ -140,4 +140,4 @@ export async function* watchChannels(input) {
         await Promise.allSettled([...tasks]);
     }
 }
-//# sourceMappingURL=watch-channels.js.map
+//# sourceMappingURL=watch-sessions.js.map

package/dist/teamwork/api/watch-sessions.js.map

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

package/dist/teamwork/api/watch.d.ts

@@ -0,0 +1,11 @@
+import { type WatchFilter } from "../internal/store/watch.js";
+import type { TeamworkEvent } from "../internal/store/events.js";
+import type { TeamworkSessionAddressOptions } from "./types.js";
+export interface WatchTeamworkSessionOptions extends TeamworkSessionAddressOptions {
+    filter?: WatchFilter;
+    signal?: AbortSignal;
+    fromStart?: boolean;
+    sinceSeq?: number;
+}
+export declare function watchTeamworkEvents(opts: WatchTeamworkSessionOptions): AsyncGenerator<TeamworkEvent, void, unknown>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/teamwork/api/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,6BAA6B;IAChF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,2BAA2B,GAChC,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAa9C"}

package/dist/{channel → teamwork}/api/watch.js

@@ -1,13 +1,13 @@
 import { watchEvents, } from "../internal/store/watch.js";
-import { resolveChannelRef } from "./resolve.js";
-export function watchChannelEvents(opts) {
-    const ref = resolveChannelRef({
-        channel: opts.channel,
+import { resolveTeamworkSession } from "./resolve.js";
+export function watchTeamworkEvents(opts) {
+    const ref = resolveTeamworkSession({
+        sessionId: opts.sessionId,
         ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
         ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
         ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
     });
-    return watchEvents(opts.channel, opts.filter ?? {}, {
+    return watchEvents(opts.sessionId, opts.filter ?? {}, {
         project: ref.project,
         ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
         ...(opts.fromStart !== undefined ? { fromStart: opts.fromStart } : {}),

package/dist/teamwork/api/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/teamwork/api/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAUtD,MAAM,UAAU,mBAAmB,CACjC,IAAiC;IAEjC,MAAM,GAAG,GAAG,sBAAsB,CAAC;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE;QACpD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/dist/{channel → teamwork}/api/workers.d.ts

@@ -1,16 +1,16 @@
-import { type ChannelEvent } from "../internal/store/events.js";
-import type { ChannelScope } from "../internal/store/schema.js";
+import { type TeamworkEvent } from "../internal/store/events.js";
+import type { TeamworkSessionScope } from "../internal/store/schema.js";
 import { type WorkerState } from "../internal/store/worker-state.js";
 export interface ListWorkersInput {
-    channel: string;
-    scope?: ChannelScope;
+    sessionId: string;
+    scope?: TeamworkSessionScope;
     projectKey?: string;
     cwd?: string;
     /** Include `done` / `error` / `killed` / `crashed` workers. Default false. */
     includeTerminal?: boolean;
 }
 /**
- * Project the durable worker registry for a channel. SOT for CLI list /
+ * Project the durable worker registry for a Teamwork Session. Source of truth for CLI list /
  * status, daemon runtime cards, and tests — do not reparse event logs
  * independently.
  */
@@ -37,15 +37,15 @@ export interface WorkerRuntimeObservation {
     source: "local-pid-files";
 }
 export interface ProbeWorkerRuntimeInput {
-    channel: string;
-    scope?: ChannelScope;
+    sessionId: string;
+    scope?: TeamworkSessionScope;
     projectKey?: string;
     cwd?: string;
 }
 /**
  * Host-local runtime observation. Reads `<worker>.pid` /
  * `<worker>.worker-pid` files and checks OS liveness. This is NOT
- * durable channel truth — `reduceWorkerRegistry` must never read pid
+ * durable event truth — `reduceWorkerRegistry` must never read pid
  * files. Only valid on the machine that owns the supervisor files.
  */
 export declare function probeWorkerRuntime(input: ProbeWorkerRuntimeInput): Promise<WorkerRuntimeObservation[]>;
@@ -56,8 +56,8 @@ export interface ReconcileWorkerLivenessInput extends ProbeWorkerRuntimeInput {
 }
 export interface ReconcileWorkerLivenessResult {
     observations: WorkerRuntimeObservation[];
-    proposedEvents: ChannelEvent[];
-    appended: ChannelEvent[];
+    proposedEvents: TeamworkEvent[];
+    appended: TeamworkEvent[];
 }
 /**
  * Reconcile durable worker state against host-local pid files. Reports

package/dist/teamwork/api/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/teamwork/api/workers.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAkBD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,EAAE,CAAC,CAOxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAuB,YAAY,CACjC,KAAK,EAAE,iBAAiB,GACvB,cAAc,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CA6B9C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAoBD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CA2BrC;AAED,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,wBAAwB,EAAE,CAAC;IACzC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA4CxC"}