@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/runtime/events/control-plane.js

@@ -0,0 +1,24 @@
+/**
+ * ControlPlaneEvent — discriminated union covering gateway/control-plane client lifecycle events.
+ */
+export const CONTROL_PLANE_CLIENT_KINDS = [
+    'tui',
+    'web',
+    'slack',
+    'discord',
+    'ntfy',
+    'daemon',
+    'webhook',
+    'service',
+    'telegram',
+    'google-chat',
+    'signal',
+    'whatsapp',
+    'imessage',
+    'msteams',
+    'bluebubbles',
+    'mattermost',
+    'matrix',
+];
+export const CONTROL_PLANE_TRANSPORT_KINDS = ['local', 'http', 'sse', 'ws', 'websocket', 'webhook'];
+export const CONTROL_PLANE_PRINCIPAL_KINDS = ['user', 'bot', 'service', 'token'];

package/dist/platform/runtime/events/deliveries.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DeliveryEvent — discriminated union covering outbound delivery attempts and outcomes.
+ */
+import type { RouteSurfaceKind } from './routes.js';
+export declare const DELIVERY_KINDS: readonly ["notification", "reply", "action", "callback"];
+export type DeliveryKind = (typeof DELIVERY_KINDS)[number];
+export type DeliveryEvent = {
+    type: 'DELIVERY_QUEUED';
+    deliveryId: string;
+    jobId: string;
+    runId: string;
+    surfaceKind: RouteSurfaceKind;
+    targetId: string;
+    deliveryKind: DeliveryKind;
+} | {
+    type: 'DELIVERY_STARTED';
+    deliveryId: string;
+    jobId: string;
+    runId: string;
+    surfaceKind: RouteSurfaceKind;
+    targetId: string;
+    startedAt: number;
+} | {
+    type: 'DELIVERY_SUCCEEDED';
+    deliveryId: string;
+    jobId: string;
+    runId: string;
+    surfaceKind: RouteSurfaceKind;
+    targetId: string;
+    completedAt: number;
+    durationMs: number;
+    statusCode: number;
+} | {
+    type: 'DELIVERY_FAILED';
+    deliveryId: string;
+    jobId: string;
+    runId: string;
+    surfaceKind: RouteSurfaceKind;
+    targetId: string;
+    failedAt: number;
+    error: string;
+    retryable: boolean;
+} | {
+    type: 'DELIVERY_DEAD_LETTERED';
+    deliveryId: string;
+    jobId: string;
+    runId: string;
+    surfaceKind: RouteSurfaceKind;
+    targetId: string;
+    reason: string;
+    attempts: number;
+};
+export type DeliveryEventType = DeliveryEvent['type'];
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/platform/runtime/events/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/deliveries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,cAAc,0DAA2D,CAAC;AAEvF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/deliveries.js

@@ -0,0 +1,4 @@
+/**
+ * DeliveryEvent — discriminated union covering outbound delivery attempts and outcomes.
+ */
+export const DELIVERY_KINDS = ['notification', 'reply', 'action', 'callback'];

package/dist/platform/runtime/events/envelope.d.ts

@@ -0,0 +1,3 @@
+export type { EventEnvelope as RuntimeEventEnvelope, EventEnvelopeContext as EnvelopeContext, } from '../event-envelope.js';
+export { createEventEnvelope } from '../event-envelope.js';
+//# sourceMappingURL=envelope.d.ts.map

package/dist/platform/runtime/events/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/envelope.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,IAAI,oBAAoB,EACrC,oBAAoB,IAAI,eAAe,GACxC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/platform/runtime/events/envelope.js

@@ -0,0 +1 @@
+export { createEventEnvelope } from '../event-envelope.js';

package/dist/platform/runtime/events/forensics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ForensicsEvent — discriminated union for failure forensics events.
+ *
+ * Emitted by the ForensicsCollector when a failure report is generated
+ * on a terminal state, and when a report is exported.
+ */
+export type ForensicsEvent = 
+/** A new failure report has been generated for a terminal task or turn. */
+{
+    type: 'FORENSICS_REPORT_CREATED';
+    /** Unique report ID (short hex prefix of trace ID). */
+    reportId: string;
+    /** Classification label for the failure. */
+    classification: string;
+    /** Primary error message. */
+    errorMessage?: string;
+    /** Task ID if this is a task failure. */
+    taskId?: string;
+    /** Turn ID if this is a turn failure. */
+    turnId?: string;
+}
+/** A report was exported (to stdout or file). */
+ | {
+    type: 'FORENSICS_REPORT_EXPORTED';
+    reportId: string;
+    destination: 'stdout' | 'file';
+    path?: string;
+};
+/** All forensics event type literals as a union. */
+export type ForensicsEventType = ForensicsEvent['type'];
+//# sourceMappingURL=forensics.d.ts.map

package/dist/platform/runtime/events/forensics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forensics.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/forensics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc;AACxB,2EAA2E;AACzE;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/forensics.js

@@ -0,0 +1,7 @@
+/**
+ * ForensicsEvent — discriminated union for failure forensics events.
+ *
+ * Emitted by the ForensicsCollector when a failure report is generated
+ * on a terminal state, and when a report is exported.
+ */
+export {};

package/dist/platform/runtime/events/knowledge.d.ts

@@ -0,0 +1,76 @@
+/**
+ * KnowledgeEvent — structured knowledge ingest, extraction, packet, projection, and job lifecycle events.
+ */
+export type KnowledgeEvent = {
+    type: 'KNOWLEDGE_INGEST_STARTED';
+    sourceId: string;
+    connectorId: string;
+    sourceType: string;
+    uri?: string;
+} | {
+    type: 'KNOWLEDGE_INGEST_COMPLETED';
+    sourceId: string;
+    status: string;
+    artifactId?: string;
+    title?: string;
+} | {
+    type: 'KNOWLEDGE_INGEST_FAILED';
+    sourceId: string;
+    error: string;
+} | {
+    type: 'KNOWLEDGE_EXTRACTION_COMPLETED';
+    sourceId: string;
+    extractionId: string;
+    format: string;
+    estimatedTokens: number;
+} | {
+    type: 'KNOWLEDGE_EXTRACTION_FAILED';
+    sourceId: string;
+    error: string;
+} | {
+    type: 'KNOWLEDGE_COMPILE_COMPLETED';
+    sourceId: string;
+    nodeCount: number;
+    edgeCount: number;
+} | {
+    type: 'KNOWLEDGE_LINT_COMPLETED';
+    issueCount: number;
+} | {
+    type: 'KNOWLEDGE_PACKET_BUILT';
+    task: string;
+    itemCount: number;
+    estimatedTokens: number;
+    detail: 'compact' | 'standard' | 'detailed';
+} | {
+    type: 'KNOWLEDGE_PROJECTION_RENDERED';
+    targetId: string;
+    pageCount: number;
+} | {
+    type: 'KNOWLEDGE_PROJECTION_MATERIALIZED';
+    targetId: string;
+    artifactId: string;
+    pageCount: number;
+} | {
+    type: 'KNOWLEDGE_JOB_QUEUED';
+    jobId: string;
+    runId: string;
+    mode: 'inline' | 'background';
+} | {
+    type: 'KNOWLEDGE_JOB_STARTED';
+    jobId: string;
+    runId: string;
+    mode: 'inline' | 'background';
+} | {
+    type: 'KNOWLEDGE_JOB_COMPLETED';
+    jobId: string;
+    runId: string;
+    durationMs: number;
+} | {
+    type: 'KNOWLEDGE_JOB_FAILED';
+    jobId: string;
+    runId: string;
+    error: string;
+    durationMs: number;
+};
+export type KnowledgeEventType = KnowledgeEvent['type'];
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/platform/runtime/events/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/knowledge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,gCAAgC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;CAC7C,GACD;IACE,IAAI,EAAE,+BAA+B,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/knowledge.js

@@ -0,0 +1,4 @@
+/**
+ * KnowledgeEvent — structured knowledge ingest, extraction, packet, projection, and job lifecycle events.
+ */
+export {};

package/dist/platform/runtime/events/mcp.d.ts

@@ -0,0 +1,90 @@
+/**
+ * McpEvent — discriminated union covering all MCP (Model Context Protocol) server events.
+ *
+ * Covers MCP server lifecycle events for the runtime event bus.
+ */
+export type McpEvent = 
+/** MCP server configuration has been parsed and validated. */
+{
+    type: 'MCP_CONFIGURED';
+    serverId: string;
+    transport: string;
+    url?: string;
+    role?: import('../mcp/types.js').McpServerRole;
+    trustMode?: import('../mcp/types.js').McpTrustMode;
+    allowedPaths?: string[];
+    allowedHosts?: string[];
+}
+/** Connection attempt to MCP server is in progress. */
+ | {
+    type: 'MCP_CONNECTING';
+    serverId: string;
+}
+/** Connection to MCP server established successfully. */
+ | {
+    type: 'MCP_CONNECTED';
+    serverId: string;
+    toolCount: number;
+    resourceCount: number;
+}
+/** MCP server is running in degraded mode (partial tool availability). */
+ | {
+    type: 'MCP_DEGRADED';
+    serverId: string;
+    reason: string;
+    availableTools: string[];
+}
+/** MCP server requires authentication before proceeding. */
+ | {
+    type: 'MCP_AUTH_REQUIRED';
+    serverId: string;
+    authType: string;
+}
+/** Attempting to re-establish a dropped MCP connection. */
+ | {
+    type: 'MCP_RECONNECTING';
+    serverId: string;
+    attempt: number;
+    maxAttempts: number;
+}
+/** Connection to MCP server has been dropped or closed. */
+ | {
+    type: 'MCP_DISCONNECTED';
+    serverId: string;
+    reason?: string;
+    willRetry: boolean;
+}
+/**
+ * MCP schema has been quarantined.
+ *
+ * Tool execution on this server is blocked until the schema is refreshed or
+ * an operator explicitly approves a temporary override.
+ */
+ | {
+    type: 'MCP_SCHEMA_QUARANTINED';
+    serverId: string;
+    reason: import('../mcp/types.js').QuarantineReason;
+    detail?: string;
+}
+/**
+ * An operator has acknowledged a quarantined schema and approved a temporary
+ * execution override. Freshness transitions to `stale`; a refresh is still
+ * recommended.
+ */
+ | {
+    type: 'MCP_SCHEMA_QUARANTINE_APPROVED';
+    serverId: string;
+    operatorId: string;
+}
+/** MCP trust/role policy has changed. */
+ | {
+    type: 'MCP_POLICY_UPDATED';
+    serverId: string;
+    role: import('../mcp/types.js').McpServerRole;
+    trustMode: import('../mcp/types.js').McpTrustMode;
+    allowedPaths: string[];
+    allowedHosts: string[];
+};
+/** All MCP event type literals as a union. */
+export type McpEventType = McpEvent['type'];
+//# sourceMappingURL=mcp.d.ts.map

package/dist/platform/runtime/events/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ;AAClB,8DAA8D;AAC5D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,iBAAiB,EAAE,YAAY,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AACrO,uDAAuD;GACrD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC9C,yDAAyD;GACvD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE;AACvF,0EAA0E;GACxE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE;AACtF,4DAA4D;GAC1D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACnE,2DAA2D;GACzD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACtF,2DAA2D;GACzD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;AACrF;;;;;GAKG;GACD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,iBAAiB,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAC3H;;;;GAIG;GACD;IAAE,IAAI,EAAE,gCAAgC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAClF,yCAAyC;GACvC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,OAAO,iBAAiB,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvM,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/mcp.js

@@ -0,0 +1,6 @@
+/**
+ * McpEvent — discriminated union covering all MCP (Model Context Protocol) server events.
+ *
+ * Covers MCP server lifecycle events for the runtime event bus.
+ */
+export {};

package/dist/platform/runtime/events/ops.d.ts

@@ -0,0 +1,81 @@
+/**
+ * OpsEvent — discriminated union covering all operator control plane events.
+ *
+ * These events are emitted when the operator intervenes in task or agent
+ * lifecycle via the /ops command or Ctrl+O panel. Every intervention emits
+ * an audit event with a reason code for traceability.
+ */
+/** Reason codes for operator interventions. */
+export type OpsInterventionReason = 'user_requested' | 'ops_cancel' | 'ops_pause' | 'ops_resume' | 'ops_retry' | 'ops_agent_cancel';
+export type OpsEvent = 
+/** Context usage crossed a warning threshold. */
+{
+    type: 'OPS_CONTEXT_WARNING';
+    usage: number;
+    threshold: number;
+}
+/** Cache hit-rate and token metrics snapshot. */
+ | {
+    type: 'OPS_CACHE_METRICS';
+    hitRate: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    totalInputTokens: number;
+    turns: number;
+}
+/** Helper-model cumulative usage snapshot. */
+ | {
+    type: 'OPS_HELPER_USAGE';
+    inputTokens: number;
+    outputTokens: number;
+    calls: number;
+}
+/** Operator cancelled a running or queued task. */
+ | {
+    type: 'OPS_TASK_CANCELLED';
+    taskId: string;
+    reason: OpsInterventionReason;
+    note?: string;
+}
+/** Operator paused a running task (transitions to blocked). */
+ | {
+    type: 'OPS_TASK_PAUSED';
+    taskId: string;
+    reason: OpsInterventionReason;
+    note?: string;
+}
+/** Operator resumed a blocked task. */
+ | {
+    type: 'OPS_TASK_RESUMED';
+    taskId: string;
+    reason: OpsInterventionReason;
+    note?: string;
+}
+/** Operator retried a failed or cancelled task. */
+ | {
+    type: 'OPS_TASK_RETRIED';
+    taskId: string;
+    reason: OpsInterventionReason;
+    note?: string;
+}
+/** Operator cancelled a running agent. */
+ | {
+    type: 'OPS_AGENT_CANCELLED';
+    agentId: string;
+    reason: OpsInterventionReason;
+    note?: string;
+}
+/** Audit trail entry for any ops intervention. */
+ | {
+    type: 'OPS_AUDIT';
+    action: string;
+    targetId: string;
+    targetKind: 'task' | 'agent';
+    reason: OpsInterventionReason;
+    note?: string;
+    outcome: 'success' | 'rejected' | 'error';
+    errorMessage?: string;
+};
+/** All ops event type literals as a union. */
+export type OpsEventType = OpsEvent['type'];
+//# sourceMappingURL=ops.d.ts.map

package/dist/platform/runtime/events/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,kBAAkB,CAAC;AAEvB,MAAM,MAAM,QAAQ;AAClB,iDAAiD;AAC/C;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,8CAA8C;GAC5C;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,+DAA+D;GAC7D;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,uCAAuC;GACrC;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,0CAA0C;GACxC;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,kDAAkD;GAChD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/ops.js

@@ -0,0 +1,8 @@
+/**
+ * OpsEvent — discriminated union covering all operator control plane events.
+ *
+ * These events are emitted when the operator intervenes in task or agent
+ * lifecycle via the /ops command or Ctrl+O panel. Every intervention emits
+ * an audit event with a reason code for traceability.
+ */
+export {};

package/dist/platform/runtime/events/orchestration.d.ts

@@ -0,0 +1,75 @@
+/**
+ * OrchestrationEvent — task-graph and bounded-recursion lifecycle events.
+ */
+export interface OrchestrationTaskContract {
+    allowedTools?: string[];
+    capabilityCeiling?: string[];
+    successCriteria?: string[];
+    requiredEvidence?: string[];
+    writeScope?: string[];
+    executionProtocol?: 'direct' | 'gather-plan-apply';
+    reviewMode?: 'none' | 'wrfc';
+    inheritsParentConstraints?: boolean;
+    communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
+}
+export type OrchestrationEvent = {
+    type: 'ORCHESTRATION_GRAPH_CREATED';
+    graphId: string;
+    title: string;
+    mode: 'single-worker' | 'parallel-workers' | 'review-loop' | 'graph-execute';
+} | {
+    type: 'ORCHESTRATION_NODE_ADDED';
+    graphId: string;
+    nodeId: string;
+    title: string;
+    role: 'planner' | 'engineer' | 'reviewer' | 'fixer' | 'verifier' | 'researcher' | 'integrator';
+    parentNodeId?: string;
+    dependsOn?: string[];
+    taskId?: string;
+    agentId?: string;
+    contract?: OrchestrationTaskContract;
+} | {
+    type: 'ORCHESTRATION_NODE_READY';
+    graphId: string;
+    nodeId: string;
+} | {
+    type: 'ORCHESTRATION_NODE_STARTED';
+    graphId: string;
+    nodeId: string;
+    taskId?: string;
+    agentId?: string;
+} | {
+    type: 'ORCHESTRATION_NODE_PROGRESS';
+    graphId: string;
+    nodeId: string;
+    message: string;
+} | {
+    type: 'ORCHESTRATION_NODE_BLOCKED';
+    graphId: string;
+    nodeId: string;
+    reason: string;
+} | {
+    type: 'ORCHESTRATION_NODE_COMPLETED';
+    graphId: string;
+    nodeId: string;
+    summary?: string;
+} | {
+    type: 'ORCHESTRATION_NODE_FAILED';
+    graphId: string;
+    nodeId: string;
+    error: string;
+} | {
+    type: 'ORCHESTRATION_NODE_CANCELLED';
+    graphId: string;
+    nodeId: string;
+    reason?: string;
+} | {
+    type: 'ORCHESTRATION_RECURSION_GUARD_TRIGGERED';
+    graphId: string;
+    nodeId?: string;
+    depth: number;
+    activeAgents: number;
+    reason: string;
+};
+export type OrchestrationEventType = OrchestrationEvent['type'];
+//# sourceMappingURL=orchestration.d.ts.map

package/dist/platform/runtime/events/orchestration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/orchestration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,mBAAmB,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iBAAiB,CAAC,EAAE,aAAa,GAAG,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACjF;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,aAAa,GAAG,eAAe,CAAA;CAAE,GACrJ;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAA;CAAE,GAC1S;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1G;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,8BAA8B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,8BAA8B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,yCAAyC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/I,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/orchestration.js

@@ -0,0 +1,4 @@
+/**
+ * OrchestrationEvent — task-graph and bounded-recursion lifecycle events.
+ */
+export {};

package/dist/platform/runtime/events/permissions.d.ts

@@ -0,0 +1,78 @@
+/**
+ * PermissionEvent — discriminated union covering all permission evaluation events.
+ *
+ * Covers permission evaluation events for the runtime event bus.
+ */
+export type PermissionEvent = 
+/** A tool call is requesting permission evaluation. */
+{
+    type: 'PERMISSION_REQUESTED';
+    callId: string;
+    tool: string;
+    args: Record<string, unknown>;
+    category: string;
+    classification?: string;
+    riskLevel?: string;
+    summary?: string;
+    reasons?: readonly string[];
+}
+/** Permission rules have been collected from all sources. */
+ | {
+    type: 'RULES_COLLECTED';
+    callId: string;
+    tool: string;
+    ruleCount: number;
+}
+/** Tool arguments have been normalised for policy evaluation. */
+ | {
+    type: 'INPUT_NORMALIZED';
+    callId: string;
+    tool: string;
+}
+/** Static policy rules have been evaluated. */
+ | {
+    type: 'POLICY_EVALUATED';
+    callId: string;
+    tool: string;
+    result: 'allow' | 'deny' | 'unknown';
+}
+/** Trust mode (yolo/normal/restricted) has been evaluated. */
+ | {
+    type: 'MODE_EVALUATED';
+    callId: string;
+    tool: string;
+    mode: string;
+    result: 'allow' | 'deny' | 'unknown';
+}
+/** Session-level overrides (always-allow list) have been evaluated. */
+ | {
+    type: 'SESSION_OVERRIDE_EVALUATED';
+    callId: string;
+    tool: string;
+    overrideApplied: boolean;
+}
+/** Safety checks (path traversal, sandbox escapes, etc.) have been run. */
+ | {
+    type: 'SAFETY_CHECKED';
+    callId: string;
+    tool: string;
+    safe: boolean;
+    warnings: string[];
+}
+/** Final permission decision has been emitted. */
+ | {
+    type: 'DECISION_EMITTED';
+    callId: string;
+    tool: string;
+    approved: boolean;
+    source: string;
+    sourceLayer?: string;
+    persisted?: boolean;
+    reasonCode?: string;
+    classification?: string;
+    riskLevel?: string;
+    summary?: string;
+};
+/** All permission event type literals as a union. */
+export type PermissionEventType = PermissionEvent['type'];
+//# sourceMappingURL=permissions.d.ts.map

package/dist/platform/runtime/events/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/permissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe;AACzB,uDAAuD;AACrD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AACH,6DAA6D;GAC3D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC9E,iEAAiE;GAC/D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC5D,+CAA+C;GAC7C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE;AAClG,8DAA8D;GAC5D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE;AAC9G,uEAAuE;GACrE;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE;AAChG,2EAA2E;GACzE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AAC7F,kDAAkD;GAChD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/permissions.js

@@ -0,0 +1,6 @@
+/**
+ * PermissionEvent — discriminated union covering all permission evaluation events.
+ *
+ * Covers permission evaluation events for the runtime event bus.
+ */
+export {};

package/dist/platform/runtime/events/planner.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PlannerEvent — discriminated union for adaptive planner decisions and overrides.
+ */
+import type { PlannerDecision, ExecutionStrategy } from '../../core/adaptive-planner.js';
+export type PlannerEvent = ({
+    type: 'PLAN_STRATEGY_SELECTED';
+} & PlannerDecision) | {
+    type: 'PLAN_STRATEGY_OVERRIDDEN';
+    strategy: ExecutionStrategy | null;
+    clearedBy?: string;
+};
+export type PlannerEventType = PlannerEvent['type'];
+//# sourceMappingURL=planner.d.ts.map

package/dist/platform/runtime/events/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/events/planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,MAAM,MAAM,YAAY,GACpB,CAAC;IACD,IAAI,EAAE,wBAAwB,CAAC;CAChC,GAAG,eAAe,CAAC,GAClB;IACA,IAAI,EAAE,0BAA0B,CAAC;IACjC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/dist/platform/runtime/events/planner.js

@@ -0,0 +1 @@
+export {};