@pellux/goodvibes-sdk 0.30.3 → 0.33.1

package/dist/platform/runtime/tasks/adapters/agent-adapter.d.ts

@@ -31,7 +31,7 @@ export declare class AgentTaskAdapter {
     /** Maps task ID → agent ID. */
     private readonly _taskToAgent;
     private readonly _dispatch;
-    /** m3: idempotency guard — prevent double-wiring the bus */
+    /** Prevent double-wiring the runtime bus. */
     private _busAttached;
     constructor(_store: RuntimeStore);
     /**
@@ -47,13 +47,11 @@ export declare class AgentTaskAdapter {
      */
     attachRuntimeBus(bus: RuntimeEventBus): () => void;
     /**
-     * M2: Reconcile adapter state on daemon restart.
+     * Reconcile adapter state on daemon restart.
      *
-     * Any task in the runtime store with status 'running' at startup is marked
-     * 'aborted' (mapped to 'cancelled') with reason 'daemon-restart', since
-     * we cannot know if the backing agent is still alive.
-     *
-     * Call this from composition after attaching the bus.
+     * Any task in the runtime store with status 'running' at startup is mapped to
+     * 'cancelled' with reason 'daemon-restart', since we cannot know if the
+     * backing agent is still alive.
      */
     reconcileOnRestart(): void;
     /**

package/dist/platform/runtime/tasks/adapters/agent-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/agent-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAkCD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAUf,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAAS;gBAEA,MAAM,EAAE,YAAY;IAMjD;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,IAAI;IA6ClD;;;;;;;;OAQG;IACH,kBAAkB,IAAI,IAAI;IA6B1B;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM;IA4BnE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAmBzE;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASjC;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAE,UAAoC,GAAG,IAAI;IAyBlG,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAkBxB"}
+{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/agent-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAwCD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAUf,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAAS;gBAEA,MAAM,EAAE,YAAY;IAMjD;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,IAAI;IAyClD;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IA6B1B;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM;IA4BnE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAmBzE;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASjC;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAE,UAAoC,GAAG,IAAI;IAyBlG,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAkBxB"}

package/dist/platform/runtime/tasks/adapters/agent-adapter.js

@@ -7,19 +7,13 @@
  */
 import { randomUUID } from 'node:crypto';
 import { createDomainDispatch } from '../../store/index.js';
+import { logger } from '../../../utils/logger.js';
 /** Terminal agent lifecycle states that map to terminal task states. */
 const TERMINAL_STATES = new Set([
     'completed',
     'failed',
     'cancelled',
 ]);
-/** Active (non-terminal, non-queued) agent states that map to 'running'. */
-const RUNNING_STATES = new Set([
-    'running',
-    'awaiting_message',
-    'awaiting_tool',
-    'finalizing',
-]);
 /**
  * Maps an agent lifecycle state string to a RuntimeTask lifecycle state.
  *
@@ -27,17 +21,25 @@ const RUNNING_STATES = new Set([
  * @returns Corresponding task lifecycle state.
  */
 function mapAgentStateToTask(state) {
-    if (state === 'spawning')
-        return 'queued';
-    if (RUNNING_STATES.has(state))
-        return 'running';
-    if (state === 'completed')
-        return 'completed';
-    if (state === 'failed')
-        return 'failed';
-    if (state === 'cancelled')
-        return 'cancelled';
-    return 'running'; // fallback for unknown states
+    switch (state) {
+        case 'spawning':
+            return 'queued';
+        case 'running':
+        case 'awaiting_message':
+        case 'awaiting_tool':
+        case 'finalizing':
+            return 'running';
+        case 'completed':
+            return 'completed';
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            return 'cancelled';
+    }
+    return assertNeverAgentState(state);
+}
+function assertNeverAgentState(state) {
+    throw new Error(`Unhandled agent lifecycle state: ${String(state)}`);
 }
 /**
  * Bridges agent sessions into the RuntimeTask registry.
@@ -57,7 +59,7 @@ export class AgentTaskAdapter {
     /** Maps task ID → agent ID. */
     _taskToAgent = new Map();
     _dispatch;
-    /** m3: idempotency guard — prevent double-wiring the bus */
+    /** Prevent double-wiring the runtime bus. */
     _busAttached = false;
     constructor(_store) {
         this._store = _store;
@@ -76,14 +78,12 @@ export class AgentTaskAdapter {
      * @returns An unsubscribe function that removes all three listeners.
      */
     attachRuntimeBus(bus) {
-        // m3: idempotent — second call is a no-op with a warning
         if (this._busAttached) {
-            console.warn('[AgentTaskAdapter] attachRuntimeBus called more than once — ignoring duplicate call');
+            logger.warn('[AgentTaskAdapter] attachRuntimeBus called more than once — ignoring duplicate call');
             return () => { };
         }
         this._busAttached = true;
         const onCompleted = bus.on('AGENT_COMPLETED', (envelope) => {
-            // m2: runtime type guard
             if (typeof envelope.payload?.agentId !== 'string')
                 return;
             const taskId = this._agentToTask.get(envelope.payload.agentId);
@@ -92,7 +92,6 @@ export class AgentTaskAdapter {
             this.handleAgentStateChange(envelope.payload.agentId, 'completed');
         });
         const onFailed = bus.on('AGENT_FAILED', (envelope) => {
-            // m2: runtime type guard
             if (typeof envelope.payload?.agentId !== 'string')
                 return;
             const taskId = this._agentToTask.get(envelope.payload.agentId);
@@ -101,7 +100,6 @@ export class AgentTaskAdapter {
             this.handleAgentStateChange(envelope.payload.agentId, 'failed');
         });
         const onCancelled = bus.on('AGENT_CANCELLED', (envelope) => {
-            // m2: runtime type guard
             if (typeof envelope.payload?.agentId !== 'string')
                 return;
             const taskId = this._agentToTask.get(envelope.payload.agentId);
@@ -117,13 +115,11 @@ export class AgentTaskAdapter {
         };
     }
     /**
-     * M2: Reconcile adapter state on daemon restart.
-     *
-     * Any task in the runtime store with status 'running' at startup is marked
-     * 'aborted' (mapped to 'cancelled') with reason 'daemon-restart', since
-     * we cannot know if the backing agent is still alive.
+     * Reconcile adapter state on daemon restart.
      *
-     * Call this from composition after attaching the bus.
+     * Any task in the runtime store with status 'running' at startup is mapped to
+     * 'cancelled' with reason 'daemon-restart', since we cannot know if the
+     * backing agent is still alive.
      */
     reconcileOnRestart() {
         const tasks = this._store.getState().tasks.tasks;

package/dist/platform/runtime/tasks/adapters/process-adapter.d.ts

@@ -17,7 +17,7 @@ export interface ProcessOwner {
     /** Session ID that spawned this process. */
     sessionId: string;
     /** Optional agent ID that owns this process. */
-    agentId?: string;
+    agentId?: string | undefined;
 }
 /**
  * Bridges ProcessManager background processes into the RuntimeTask registry.
@@ -69,7 +69,7 @@ export declare class ProcessTaskAdapter {
      * Reconcile adapter state with the RuntimeTask registry.
      *
      * Scans all ProcessManager processes:
-     * - Wraps any un-tracked processes as new tasks (with a fallback owner).
+     * - Wraps any un-tracked processes as new tasks (with a derived owner).
      * - Marks completed (done) processes as completed or failed in the task store.
      * - Removes task mappings for processes that have been cleaned up.
      *

package/dist/platform/runtime/tasks/adapters/process-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/process-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAGxB,MAAM,EAAE,YAAY,EACrC,OAAO,EAAE,cAAc;IAQzB;;;;;;;;OAQG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,MAAM;IA+BT;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAetD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAanC;;;;;;;;;OASG;IACH,IAAI,CAAC,YAAY,GAAE,YAAsC,GAAG,IAAI;IAuChE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAgBxB"}
+{"version":3,"file":"process-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/process-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAGxB,MAAM,EAAE,YAAY,EACrC,OAAO,EAAE,cAAc;IAQzB;;;;;;;;OAQG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,MAAM;IA+BT;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAetD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAanC;;;;;;;;;OASG;IACH,IAAI,CAAC,YAAY,GAAE,YAAsC,GAAG,IAAI;IAuChE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAgBxB"}

package/dist/platform/runtime/tasks/adapters/process-adapter.js

@@ -117,7 +117,7 @@ export class ProcessTaskAdapter {
      * Reconcile adapter state with the RuntimeTask registry.
      *
      * Scans all ProcessManager processes:
-     * - Wraps any un-tracked processes as new tasks (with a fallback owner).
+     * - Wraps any un-tracked processes as new tasks (with a derived owner).
      * - Marks completed (done) processes as completed or failed in the task store.
      * - Removes task mappings for processes that have been cleaned up.
      *

package/dist/platform/runtime/tasks/adapters/scheduler-adapter.d.ts

@@ -51,7 +51,7 @@ export declare class SchedulerTaskAdapter {
      * @param status - Terminal status: 'completed' or 'failed'.
      * @param error - Optional error message if status is 'failed'.
      */
-    handleRunComplete(runAgentId: string, status: 'completed' | 'failed', error?: string): void;
+    handleRunComplete(runAgentId: string, status: 'completed' | 'failed', error?: string | undefined): void;
     /**
      * Cancel a scheduled run task by task ID.
      * Marks the task as cancelled. The caller is responsible for disabling the

package/dist/platform/runtime/tasks/adapters/scheduler-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/scheduler-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEnG;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAEd,MAAM,EAAE,YAAY;IAMjD;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM;IAkC7E;;;;;;OAMG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IASP;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASrC;;;;;;;;OAQG;IACH,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAsCpC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAexB"}
+{"version":3,"file":"scheduler-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/tasks/adapters/scheduler-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAkBnG;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAEd,MAAM,EAAE,YAAY;IAMjD;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM;IAmC7E;;;;;;OAMG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI;IASP;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASrC;;;;;;;;OAQG;IACH,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IA6CpC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAexB"}

package/dist/platform/runtime/tasks/adapters/scheduler-adapter.js

@@ -12,6 +12,20 @@
  */
 import { randomUUID } from 'node:crypto';
 import { createDomainDispatch } from '../../store/index.js';
+function mapSchedulerRunStatus(status) {
+    switch (status) {
+        case 'running':
+            return 'running';
+        case 'completed':
+            return 'completed';
+        case 'failed':
+            return 'failed';
+    }
+    return assertNeverSchedulerRunStatus(status);
+}
+function assertNeverSchedulerRunStatus(status) {
+    throw new Error(`Unhandled scheduler run status: ${String(status)}`);
+}
 /**
  * Bridges TaskScheduler job executions into the RuntimeTask registry.
  *
@@ -54,6 +68,7 @@ export class SchedulerTaskAdapter {
             return existing;
         const taskId = randomUUID();
         const now = record.startedAt;
+        const status = mapSchedulerRunStatus(record.status);
         const task = {
             id: taskId,
             kind: 'scheduler',
@@ -61,13 +76,13 @@ export class SchedulerTaskAdapter {
             description: scheduledTask.prompt.length > 200
                 ? `${scheduledTask.prompt.slice(0, 197)}...`
                 : scheduledTask.prompt,
-            status: record.status === 'running' ? 'running' : 'completed',
+            status,
             owner: `scheduler:${scheduledTask.id}`,
-            cancellable: record.status === 'running',
+            cancellable: status === 'running',
             childTaskIds: [],
             queuedAt: now,
             startedAt: now,
-            endedAt: record.status !== 'running' ? Date.now() : undefined,
+            endedAt: status !== 'running' ? Date.now() : undefined,
             correlationId: record.agentId,
             turnId: record.taskId,
             error: record.error,
@@ -141,8 +156,17 @@ export class SchedulerTaskAdapter {
         for (const runAgentId of staleRunIds) {
             const taskId = this._runToTask.get(runAgentId);
             const record = historyByAgentId.get(runAgentId);
-            const terminalStatus = record?.status === 'failed' ? 'failed' : 'completed';
-            this._transitionTask(taskId, terminalStatus, { error: record?.error });
+            if (!record) {
+                this._transitionTask(taskId, 'cancelled', {
+                    error: `Scheduler run ${runAgentId} disappeared before terminal status was recorded`,
+                });
+            }
+            else {
+                const terminalStatus = mapSchedulerRunStatus(record.status);
+                if (terminalStatus === 'running')
+                    continue;
+                this._transitionTask(taskId, terminalStatus, { error: record.error });
+            }
             this._runToTask.delete(runAgentId);
             this._taskToRun.delete(taskId);
         }

package/dist/platform/runtime/tasks/types.d.ts

@@ -17,17 +17,17 @@ export interface TaskCreateParams {
     /** Subsystem or agent ID that owns this task. */
     owner: string;
     /** Optional detailed description. */
-    description?: string;
+    description?: string | undefined;
     /** Parent task ID if this is a subtask. */
-    parentTaskId?: string;
+    parentTaskId?: string | undefined;
     /** Whether this task can be cancelled by the user. Defaults to `true`. */
-    cancellable?: boolean;
+    cancellable?: boolean | undefined;
     /** Retry policy (undefined = no retries). */
-    retryPolicy?: TaskRetryPolicy;
+    retryPolicy?: TaskRetryPolicy | undefined;
     /** Correlation ID for distributed tracing. */
-    correlationId?: string;
+    correlationId?: string | undefined;
     /** Turn ID this task was spawned within. */
-    turnId?: string;
+    turnId?: string | undefined;
 }
 /**
  * Parameters accepted by `TaskManager.updateTask()` to patch mutable
@@ -38,20 +38,20 @@ export interface TaskCreateParams {
  */
 export interface TaskUpdateParams {
     /** Updated human-readable title. */
-    title?: string;
+    title?: string | undefined;
     /** Updated description. */
-    description?: string;
+    description?: string | undefined;
     /** Updated exit code (exec tasks). */
-    exitCode?: number;
+    exitCode?: number | undefined;
     /** Updated result payload. */
-    result?: unknown;
+    result?: unknown | undefined;
 }
 /**
  * Parameters accepted by `TaskManager.cancelTask()`.
  */
 export interface TaskCancelParams {
     /** Human-readable reason for cancellation. */
-    reason?: string;
+    reason?: string | undefined;
 }
 /**
  * Parameters accepted by `TaskManager.failTask()`.
@@ -60,7 +60,7 @@ export interface TaskFailParams {
     /** Error message describing the failure. */
     error: string;
     /** Exit code if applicable (exec tasks). */
-    exitCode?: number;
+    exitCode?: number | undefined;
 }
 /**
  * TaskManager — the public interface for the unified task management system.

package/dist/platform/runtime/tasks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/tasks/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAM5G;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAElD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAEvC;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAEvD;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAE5D;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,CAAC;IAE9D;;;;;;;;OAQG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAEnE;;;;;;;;OAQG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAElE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAEjD;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE9C;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE,CAAC;IAEjC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAExC;;;;OAIG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAEnD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE9D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/tasks/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/telemetry/api-helpers.d.ts

@@ -1,4 +1,4 @@
-import type { ErrorSource } from '../../types/errors.js';
+import type { PlatformErrorSource } from '../../types/errors.js';
 import type { NormalizedError } from '../../utils/error-display.js';
 import type { AnyRuntimeEvent, RuntimeEventDomain, RuntimeEventEnvelope } from '../events/index.js';
 import type { RuntimeStore } from '../store/index.js';
@@ -7,7 +7,7 @@ import type { TelemetryAggregates, TelemetryListResponse, TelemetryPageInfo, Tel
 export declare const SERVICE_NAME = "goodvibes-sdk";
 export declare const DEFAULT_EVENT_LIMIT = 500;
 /**
- * OBS-22: Allowlist of metric label keys permitted in telemetry attributes.
+ * Allowlist of metric label keys permitted in telemetry attributes.
  * Keys outside this set are stripped before storage to prevent high-cardinality
  * label explosion in metrics backends (Prometheus, OTLP, etc.).
  */
@@ -24,14 +24,14 @@ export declare function toOtlpAttributes(attributes: Record<string, unknown>): A
     value: Record<string, unknown>;
 }>;
 export declare function inferSeverity(type: string, error?: NormalizedError): TelemetrySeverity;
-export declare function inferErrorSource(domain: RuntimeEventDomain): ErrorSource;
+export declare function inferErrorSource(domain: RuntimeEventDomain): PlatformErrorSource;
 export declare function summarizePayload(type: string, payload: unknown): string;
 export declare function normalizePayload(payload: unknown): Record<string, unknown>;
 export declare function extractProvider(payload: Record<string, unknown>): string | undefined;
 export declare function extractErrorCandidate(payload: Record<string, unknown>): string | undefined;
 export declare function isErrorEventType(type: string): boolean;
 /**
- * OBS-22: Filter metric labels against the allowlist to prevent high-cardinality
+ * Filter metric labels against the allowlist to prevent high-cardinality
  * label injection into metrics backends. Non-allowlisted keys are dropped.
  *
  * Note: full event attribute payloads (for telemetry records) are NOT filtered —

package/dist/platform/runtime/telemetry/api-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-helpers.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/api-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-helpers.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/api-helpers.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/telemetry/api-helpers.js

@@ -5,7 +5,7 @@ import { redactStructuredData } from '../../utils/redaction.js';
 export const SERVICE_NAME = 'goodvibes-sdk';
 export const DEFAULT_EVENT_LIMIT = 500;
 /**
- * OBS-22: Allowlist of metric label keys permitted in telemetry attributes.
+ * Allowlist of metric label keys permitted in telemetry attributes.
  * Keys outside this set are stripped before storage to prevent high-cardinality
  * label explosion in metrics backends (Prometheus, OTLP, etc.).
  */
@@ -38,7 +38,7 @@ export const METRIC_LABEL_ALLOWLIST = new Set([
     'error_source',
     // Stream labels
     'stream_type',
-    // Listener/event labels (OBS-13)
+    // Listener/event labels
     'event_type',
 ]);
 export const DEFAULT_ERROR_LIMIT = 250;
@@ -77,7 +77,7 @@ export const ALL_DOMAINS = [
     'knowledge',
 ];
 function hashHex(value, length) {
-    return createHash('sha1').update(value).digest('hex').slice(0, length);
+    return createHash('sha256').update(value).digest('hex').slice(0, length);
 }
 export function normalizeTraceId(traceId) {
     if (!traceId || traceId.trim().length === 0)
@@ -233,7 +233,7 @@ export function isErrorEventType(type) {
     return /(^|_)(ERROR|FAILED|FAIL|TERMINAL_FAILURE)(_|$)/.test(type);
 }
 /**
- * OBS-22: Filter metric labels against the allowlist to prevent high-cardinality
+ * Filter metric labels against the allowlist to prevent high-cardinality
  * label injection into metrics backends. Non-allowlisted keys are dropped.
  *
  * Note: full event attribute payloads (for telemetry records) are NOT filtered —
@@ -249,8 +249,8 @@ export function filterMetricLabels(labels) {
     return out;
 }
 export function buildAttributes(domain, envelope, payload) {
-    // C-2: merge correlation context so every event emitted from within a
-    // correlationCtx.run() scope automatically carries the ambient IDs.
+    // Merge correlation context so every event emitted from within a
+    // correlationCtx.run() scope carries the ambient IDs.
     const ctx = getCorrelationContext();
     return {
         domain,

package/dist/platform/runtime/telemetry/api-ingest.d.ts

@@ -0,0 +1,18 @@
+import type { TelemetryRecord } from './api.js';
+import type { ReadableSpan } from './types.js';
+interface IngestTelemetryBaseInput {
+    readonly payload: Record<string, unknown>;
+    readonly eventLimit: number;
+    readonly records: TelemetryRecord[];
+    readonly recordEvent: (type: string, record: TelemetryRecord) => void;
+    readonly nextSequence: () => number;
+}
+export declare function ingestExternalTelemetryLogs(input: IngestTelemetryBaseInput): void;
+export declare function ingestExternalTelemetryTraces(input: IngestTelemetryBaseInput & {
+    readonly spanLimit: number;
+    readonly spans: ReadableSpan[];
+    readonly peekSequence: () => number;
+}): void;
+export declare function ingestExternalTelemetryMetrics(input: IngestTelemetryBaseInput): void;
+export {};
+//# sourceMappingURL=api-ingest.d.ts.map

package/dist/platform/runtime/telemetry/api-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-ingest.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/api-ingest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,UAAU,wBAAwB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC;CACrC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAcjF;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,wBAAwB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC;CACrC,GACA,IAAI,CAsCN;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAsBpF"}

package/dist/platform/runtime/telemetry/api-ingest.js

@@ -0,0 +1,109 @@
+import { SpanKind as SpanKinds, SpanStatusCode } from './types.js';
+import { appendBounded, buildSpanId, normalizeTraceId, } from './api-helpers.js';
+export function ingestExternalTelemetryLogs(input) {
+    const resourceLogs = Array.isArray(input.payload['resourceLogs']) ? input.payload['resourceLogs'] : [];
+    for (const resource of resourceLogs) {
+        const scopeLogs = listNestedArray(resource, 'scopeLogs');
+        for (const scope of scopeLogs) {
+            const logRecords = listNestedArray(scope, 'logRecords');
+            for (const logRecord of logRecords) {
+                const entry = objectRecord(logRecord);
+                const record = buildIngestedTelemetryRecord('OTLP_LOG_INGEST', entry, input.nextSequence);
+                appendBounded(input.records, record, input.eventLimit);
+                input.recordEvent('OTLP_LOG_INGEST', record);
+            }
+        }
+    }
+}
+export function ingestExternalTelemetryTraces(input) {
+    const resourceSpans = Array.isArray(input.payload['resourceSpans']) ? input.payload['resourceSpans'] : [];
+    let spansAppended = 0;
+    for (const resource of resourceSpans) {
+        const scopeSpans = listNestedArray(resource, 'scopeSpans');
+        for (const scope of scopeSpans) {
+            const spans = listNestedArray(scope, 'spans');
+            for (const spanPayload of spans) {
+                const entry = objectRecord(spanPayload);
+                const traceId = typeof entry['traceId'] === 'string' ? entry['traceId'] : normalizeTraceId(undefined);
+                const spanId = typeof entry['spanId'] === 'string' ? entry['spanId'] : buildSpanId(`otlp:${input.peekSequence()}`);
+                const name = typeof entry['name'] === 'string' ? entry['name'] : 'otlp.span';
+                const startMs = typeof entry['startTimeUnixNano'] === 'number'
+                    ? Math.floor(entry['startTimeUnixNano'] / 1_000_000)
+                    : Date.now();
+                const endMs = typeof entry['endTimeUnixNano'] === 'number'
+                    ? Math.floor(entry['endTimeUnixNano'] / 1_000_000)
+                    : startMs;
+                appendBounded(input.spans, {
+                    name,
+                    kind: SpanKinds.INTERNAL,
+                    spanContext: { traceId, spanId, isValid: true },
+                    startTimeMs: startMs,
+                    endTimeMs: endMs,
+                    durationMs: endMs - startMs,
+                    attributes: {},
+                    events: [],
+                    status: { code: SpanStatusCode.UNSET },
+                    instrumentationScope: 'otlp-ingest',
+                }, input.spanLimit);
+                spansAppended += 1;
+            }
+        }
+    }
+    if (spansAppended === 0)
+        return;
+    const record = buildIngestedTelemetryRecord('OTLP_TRACE_INGEST', input.payload, input.nextSequence);
+    appendBounded(input.records, record, input.eventLimit);
+    input.recordEvent('OTLP_TRACE_INGEST', record);
+}
+export function ingestExternalTelemetryMetrics(input) {
+    const resourceMetrics = Array.isArray(input.payload['resourceMetrics']) ? input.payload['resourceMetrics'] : [];
+    let datapointsFound = 0;
+    for (const resource of resourceMetrics) {
+        const scopeMetrics = listNestedArray(resource, 'scopeMetrics');
+        for (const scope of scopeMetrics) {
+            const metrics = listNestedArray(scope, 'metrics');
+            for (const metric of metrics) {
+                const metricRecord = objectRecord(metric);
+                for (const signalKey of ['sum', 'gauge', 'histogram', 'exponentialHistogram', 'summary']) {
+                    const signal = metricRecord[signalKey];
+                    if (typeof signal !== 'object' || signal === null)
+                        continue;
+                    const dataPoints = signal['dataPoints'];
+                    if (Array.isArray(dataPoints))
+                        datapointsFound += dataPoints.length;
+                }
+            }
+        }
+    }
+    if (datapointsFound === 0)
+        return;
+    const record = buildIngestedTelemetryRecord('OTLP_METRICS_INGEST', input.payload, input.nextSequence);
+    appendBounded(input.records, record, input.eventLimit);
+    input.recordEvent('OTLP_METRICS_INGEST', record);
+}
+function buildIngestedTelemetryRecord(type, payload, nextSequence) {
+    const domain = 'ops';
+    const now = Date.now();
+    const seq = nextSequence();
+    return {
+        id: `${domain}:${type}:${now}:${seq}`,
+        domain,
+        type,
+        timestamp: now,
+        severity: 'info',
+        traceId: normalizeTraceId(undefined),
+        sessionId: '',
+        source: 'otlp-ingest',
+        message: `OTLP ingest: ${type}`,
+        payload,
+        attributes: {},
+    };
+}
+function listNestedArray(value, key) {
+    return typeof value === 'object' && value !== null && Array.isArray(value[key])
+        ? value[key]
+        : [];
+}
+function objectRecord(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}

package/dist/platform/runtime/telemetry/api-query.d.ts

@@ -0,0 +1,14 @@
+import type { ReadableSpan } from './types.js';
+import type { TelemetryFilter, TelemetryPageInfo, TelemetryRecord, TelemetryViewMode } from './api.js';
+export declare function applyTelemetryRecordFilter(records: readonly TelemetryRecord[], filter: TelemetryFilter, view: TelemetryViewMode): {
+    items: readonly TelemetryRecord[];
+    pageInfo: TelemetryPageInfo;
+};
+export declare function applyTelemetrySpanFilter(spans: readonly ReadableSpan[], filter: TelemetryFilter, view: TelemetryViewMode): {
+    items: readonly ReadableSpan[];
+    pageInfo: TelemetryPageInfo;
+};
+export declare function telemetryRecordMatches(record: TelemetryRecord, filter: TelemetryFilter): boolean;
+export declare function resolveTelemetryRecordCursor(records: readonly TelemetryRecord[], cursor: string): number;
+export declare function resolveTelemetrySpanCursor(spans: readonly ReadableSpan[], cursor: string): number;
+//# sourceMappingURL=api-query.d.ts.map

package/dist/platform/runtime/telemetry/api-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-query.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/api-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,iBAAiB,GACtB;IAAE,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CAqBpE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,iBAAiB,GACtB;IAAE,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CA6BjE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAYhG;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjG"}