octoflow-core 1.0.0

package/dist/runtime/bridge/events/event-map-runtime.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Runtime events: cache, middleware, plugin compat, bridge lifecycle,
+ * A2A observability, and fabric access.
+ */
+import type { BackendName } from '../../../domain/core-client.js';
+import type { PromptCacheUsageSource, PromptCacheWriteTokensByTtl } from '../../../domain/prompt-cache.js';
+import type { RunEvent } from '../../orchestration/run/event-types.js';
+import type { FabricEventContext } from './shared.js';
+type AgentRunEvent<K extends RunEvent['kind']> = Extract<RunEvent, {
+    kind: K;
+}>;
+export interface RuntimeEventMap {
+    'agent:close': {
+        agentType: string;
+        runtime: 'bridge' | 'pack';
+    };
+    'agent:loop-iteration': AgentRunEvent<'loop-iteration'>;
+    'agent:loop-terminated': AgentRunEvent<'loop-terminated'>;
+    'agent:loop-paused': AgentRunEvent<'loop-paused'>;
+    'agent:task-start': AgentRunEvent<'task-start'>;
+    'agent:task-complete': AgentRunEvent<'task-complete'>;
+    'agent:task-failed': AgentRunEvent<'task-failed'>;
+    'agent:task-batch-complete': AgentRunEvent<'task-batch-complete'>;
+    'agent:task-batch-truncated': AgentRunEvent<'task-batch-truncated'>;
+    'agent:flow-step-start': AgentRunEvent<'flow-step-start'>;
+    'agent:flow-step-complete': AgentRunEvent<'flow-step-complete'>;
+    'agent:flow-terminated': AgentRunEvent<'flow-terminated'>;
+    'bridge:cache:hit': {
+        backend: BackendName;
+        taskId: string;
+        contextId: string;
+        cachedInputTokens: number;
+        cacheWriteTokens: number;
+        partsCached: number;
+        totalInputTokens?: number;
+        uncachedInputTokens?: number;
+        cacheHitRatio?: number;
+        source?: PromptCacheUsageSource;
+        cacheWriteTokensByTtl?: PromptCacheWriteTokensByTtl;
+        promptCacheKey?: string;
+    };
+    'bridge:cache:miss': {
+        backend: BackendName;
+        taskId: string;
+        contextId: string;
+        reason: 'first-call' | 'ttl-expired' | 'prefix-changed' | 'backend-unsupported';
+    };
+    'middleware:error': {
+        phase: string;
+        plugin: string;
+        error: {
+            name: string;
+            message: string;
+        };
+        recovered: boolean;
+    };
+    'plugin:compat:unsupported': {
+        plugin: string;
+        method: string;
+    };
+    'plugin:order:resolved': {
+        order: string[];
+    };
+    'plugin:contract:mismatch': {
+        plugin: string;
+        expected: number;
+        found: number;
+    };
+    'bridge:warn': {
+        code: string;
+        message: string;
+    };
+    'policy:decision': {
+        action: string;
+        effect: 'allow' | 'deny' | 'ask';
+        reason?: string;
+        subjectId: string;
+        resourceKind: string;
+        resourceId?: string;
+        tenant?: string;
+        contextId?: string;
+        taskId?: string;
+        backend?: string;
+        auditTags?: readonly string[];
+    };
+    'token:estimator:tiktoken-loaded': {
+        encoding: string;
+    };
+    'token:estimator:heuristic-fallback': {
+        encoding: string;
+        error?: string;
+    };
+    'bridge:destroy': {
+        contextIds: string[];
+    };
+    'bridge:parser:error': {
+        backend: string;
+        reason: string;
+        raw?: string;
+    };
+    'validation:failed': {
+        boundary: string;
+        schemaPath: string;
+        errorCount: number;
+    };
+    'a2a:rpc:error': {
+        code: number;
+        errorClass: string;
+    };
+    'fabric:channel-created': FabricEventContext & {
+        kind: 'kv' | 'log';
+    };
+    'fabric:write': FabricEventContext & {
+        operation: 'set' | 'append' | 'delete';
+        key?: string;
+    };
+    'fabric:read': FabricEventContext & {
+        operation: 'get' | 'read' | 'keys' | 'snapshot';
+    };
+    'fabric:access-denied': FabricEventContext & {
+        operation: 'read' | 'write';
+        reason: string;
+    };
+    'fabric:scope-created': {
+        parentContextId: string;
+        childContextId: string;
+        inheritedChannels: string[];
+    };
+    'pack:results-truncated': {
+        packId: string;
+        round: number;
+        worker: string;
+        originalTokens: number;
+        budget: number;
+    };
+}
+export {};
+//# sourceMappingURL=event-map-runtime.d.ts.map

package/dist/runtime/bridge/events/event-map-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map-runtime.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/event-map-runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bridge/events/event-map-runtime.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-map-runtime.js.map

package/dist/runtime/bridge/events/event-map-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events/event-map-scheduler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Scheduler daemon events emitted by `octoflow-scheduler`. Payload shapes
+ * are minimal on purpose; new fields are additive and must not break older
+ * subscribers.
+ */
+export interface SchedulerTickPayload {
+    schedulerId: string;
+    tickAtMs: number;
+    /** True if this process won the leader-election claim for the tick. */
+    leader: boolean;
+}
+export interface SchedulerRunStartPayload {
+    schedulerId: string;
+    jobId: string;
+    jobName: string;
+    runAt: string;
+}
+export interface SchedulerRunEndPayload {
+    schedulerId: string;
+    jobId: string;
+    jobName: string;
+    outcome: 'success' | 'failure' | 'canceled';
+    durationMs: number;
+    error?: string;
+}
+export interface SchedulerDeliveryPayload {
+    schedulerId: string;
+    jobId: string;
+    delivery: {
+        kind: 'local';
+    } | {
+        kind: 'origin';
+    } | {
+        kind: 'platform';
+        platform: string;
+        chatId: string;
+        threadId?: string;
+    };
+    delivered: boolean;
+    error?: string;
+}
+export interface SchedulerEventMap {
+    'task:scheduler:tick': SchedulerTickPayload;
+    'task:scheduler:run-start': SchedulerRunStartPayload;
+    'task:scheduler:run-end': SchedulerRunEndPayload;
+    'task:scheduler:delivery': SchedulerDeliveryPayload;
+}
+//# sourceMappingURL=event-map-scheduler.d.ts.map

package/dist/runtime/bridge/events/event-map-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/event-map-scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EACJ;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GACjB;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAClB;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,qBAAqB,EAAE,oBAAoB,CAAC;IAC5C,0BAA0B,EAAE,wBAAwB,CAAC;IACrD,wBAAwB,EAAE,sBAAsB,CAAC;IACjD,yBAAyB,EAAE,wBAAwB,CAAC;CACrD"}

package/dist/runtime/bridge/events/event-map-scheduler.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-map-scheduler.js.map

package/dist/runtime/bridge/events/event-map-scheduler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events/event-map-skills.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Skill discovery / activation and local-context events.
+ */
+import type { ProtectedOverflowInfo } from '../../../capabilities/context-compaction-types.js';
+export interface SkillsEventMap {
+    'skill:discovered': {
+        name: string;
+        scope: 'project' | 'user' | 'admin' | 'custom';
+        source: string;
+        location: string;
+    };
+    'skill:catalogInjected': {
+        skillCount: number;
+        tokenEstimate: number;
+    };
+    'skill:activated': {
+        name: string;
+        mechanism: 'action' | 'file-read';
+        bodyTokens: number;
+    };
+    'skill:activationFailed': {
+        name: string;
+        error: string;
+    };
+    'skill:parse:warning': {
+        path: string;
+        field?: string;
+        reason: string;
+    };
+    'skill:parse:info': {
+        path: string;
+        field?: string;
+        reason: string;
+    };
+    'skill:validation:failed': {
+        path: string;
+        issues: Array<{
+            severity: 'error' | 'warning';
+            field?: string;
+            message: string;
+            location: string;
+        }>;
+    };
+    'skill:validation:warning': {
+        path: string;
+        issues: Array<{
+            severity: 'error' | 'warning';
+            field?: string;
+            message: string;
+            location: string;
+        }>;
+    };
+    'skill:protection:overflow': ProtectedOverflowInfo;
+    'skill:symlink:created': {
+        skill: string;
+        targetPath: string;
+    };
+    'skill:symlink:refreshed': {
+        skill: string;
+        targetPath: string;
+    };
+    'skill:symlink:skipped': {
+        skill: string;
+        targetPath: string;
+        reason: 'user-owned-symlink' | 'non-symlink-target';
+    };
+    'skill:symlink:failed': {
+        skill: string;
+        targetPath: string;
+        error: string;
+    };
+    'local-context:discovered': {
+        mcpServerCount: number;
+        skillCount: number;
+        sources: Array<{
+            vendor: string;
+            path: string;
+            scope: 'project' | 'user';
+            type: 'mcp' | 'skill';
+        }>;
+    };
+    'local-context:parse:warning': {
+        vendor: string;
+        path: string;
+        reason: string;
+    };
+    'local-context:security:reject': {
+        vendor: string;
+        path: string;
+        reason: 'symlink-escape' | 'outside-home';
+    };
+    'local-context:harness:detected': {
+        vendor: string;
+        matchedEnvVar: string;
+        ignoredKinds: {
+            mcp: boolean;
+            skills: boolean;
+        };
+    };
+    'local-context:harness:detected:unverified': {
+        vendor: string;
+        matchedEnvVar: string;
+        reason: 'unverified-marker-opted-in-by-user';
+    };
+    'local-context:path:unverified': {
+        vendor: string;
+        path: string;
+    };
+}
+//# sourceMappingURL=event-map-skills.d.ts.map

package/dist/runtime/bridge/events/event-map-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map-skills.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/event-map-skills.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bridge/events/event-map-skills.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-map-skills.js.map

package/dist/runtime/bridge/events/event-map-skills.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events/event-map-task.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Task / backend lifecycle events.
+ */
+import type { BackendSwitchInfo } from '../../../domain/bridge-api.js';
+import type { BackendName } from '../../../domain/core-client.js';
+import type { ErrorInfo, FallbackInfo, RetryInfo } from '../../../domain/core-task.js';
+import type { ContextCompactionEndInfo, ContextCompactionStartInfo } from '../../sessions/compaction-types.js';
+import type { TaskEventContext } from './shared.js';
+export interface TaskEventMap {
+    'task:created': TaskEventContext & {
+        message: string;
+    };
+    'task:compaction:start': TaskEventContext & Omit<ContextCompactionStartInfo, 'backend' | 'contextId' | 'taskId'>;
+    'task:compaction:end': TaskEventContext & Omit<ContextCompactionEndInfo, 'backend' | 'contextId' | 'taskId'>;
+    'agent:compaction': TaskEventContext & Omit<ContextCompactionEndInfo, 'backend' | 'contextId' | 'taskId'>;
+    'task:working': TaskEventContext;
+    'task:completed': TaskEventContext & {
+        text: string;
+    };
+    'task:failed': TaskEventContext & {
+        error: ErrorInfo;
+    };
+    'task:canceled': {
+        taskId: string;
+        contextId: string;
+    };
+    /**
+     * Fired for each text chunk streamed by the backend as it arrives.
+     *
+     * Enables real-time output from CLI backends (claude-code-cli, cursor-cli,
+     * codex-cli) and API streaming without waiting for `task:completed`.
+     * Multiple `bridge:message` events accumulate into the final `task:completed.text`.
+     *
+     * Use `agent.on('bridge:message', ({ text }) => process.stdout.write(text))`
+     * to display output as it is produced, or to return messages to users
+     * during long-running pipeline steps.
+     */
+    'bridge:message': TaskEventContext & {
+        text: string;
+    };
+    /**
+     * Fired for each reasoning/thinking chunk from extended-thinking backends
+     * (Anthropic extended thinking, OpenAI o-series).
+     *
+     * Mirrors `bridge:message` but for the chain-of-thought stream. The AG-UI
+     * gateway maps these chunks to `REASONING_MESSAGE_CONTENT` events.
+     * Reasoning always precedes the main text reply in a single turn.
+     */
+    'bridge:thinking': TaskEventContext & {
+        text: string;
+    };
+    'backend:selected': {
+        contextId: string;
+        backend: BackendName;
+    };
+    'backend:switched': BackendSwitchInfo;
+    'backend:retry': RetryInfo & {
+        taskId: string;
+        contextId: string;
+    };
+    'backend:fallback': FallbackInfo & {
+        taskId: string;
+        contextId: string;
+    };
+    'backend:error': ErrorInfo & {
+        taskId: string;
+        contextId: string;
+    };
+}
+//# sourceMappingURL=event-map-task.d.ts.map

package/dist/runtime/bridge/events/event-map-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map-task.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/event-map-task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,gBAAgB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,uBAAuB,EAAE,gBAAgB,GACvC,IAAI,CAAC,0BAA0B,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IACvE,qBAAqB,EAAE,gBAAgB,GACrC,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IACrE,kBAAkB,EAAE,gBAAgB,GAClC,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IACrE,cAAc,EAAE,gBAAgB,CAAC;IACjC,gBAAgB,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,aAAa,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IACvD,eAAe,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvD;;;;;;;;;;OAUG;IACH,gBAAgB,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtD;;;;;;;OAOG;IACH,iBAAiB,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvD,kBAAkB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAChE,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,eAAe,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,kBAAkB,EAAE,YAAY,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,eAAe,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE"}

package/dist/runtime/bridge/events/event-map-task.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-map-task.js.map

package/dist/runtime/bridge/events/event-map-task.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events/event-map-tui.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TUI events emitted by `octoflow-tui`. Payload shapes are minimal on
+ * purpose; new fields are additive and must not break older subscribers.
+ */
+export interface TuiCommandDispatchedPayload {
+    command: string;
+    args: readonly string[];
+    /** Renderer that handled the command (`'ink'` for v0.1, `'opentui'` later). */
+    renderer: string;
+}
+export interface TuiSlashCompletedPayload {
+    prefix: string;
+    matched: readonly string[];
+    durationMs: number;
+}
+export interface TuiEventMap {
+    'tui:command-dispatched': TuiCommandDispatchedPayload;
+    'tui:slash-completed': TuiSlashCompletedPayload;
+}
+//# sourceMappingURL=event-map-tui.d.ts.map

package/dist/runtime/bridge/events/event-map-tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map-tui.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/event-map-tui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,wBAAwB,EAAE,2BAA2B,CAAC;IACtD,qBAAqB,EAAE,wBAAwB,CAAC;CACjD"}

package/dist/runtime/bridge/events/event-map-tui.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-map-tui.js.map

package/dist/runtime/bridge/events/event-map-tui.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events/shared.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared event context fragments.
+ *
+ * Every event in the catalog eventually extends one of these — keeping them
+ * in a single module lets each domain event map stay short and self-contained.
+ */
+import type { BackendName } from '../../../domain/core-client.js';
+/** Task-scoped context stamped on every lifecycle / action / MCP event. */
+export interface TaskEventContext {
+    taskId: string;
+    contextId: string;
+    backend: BackendName;
+}
+/** Some plugin events (`brain:*`, `memory:*`) fire outside a task run. */
+export interface OptionalTaskContext {
+    taskId?: string;
+    contextId?: string;
+}
+/** Fabric events always carry the channel + caller identity. */
+export interface FabricEventContext {
+    channelName: string;
+    agentId: string;
+    contextId: string;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/runtime/bridge/events/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/events/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/runtime/bridge/events/shared.js

@@ -0,0 +1 @@
+//# sourceMappingURL=shared.js.map

package/dist/runtime/bridge/events/shared.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events-contracts.d.ts

@@ -0,0 +1,39 @@
+import type { RunEvent } from '../orchestration/run/event-types.js';
+import type { ApprovalEventMap } from './events/event-map-approval.js';
+import type { AuthEventMap } from './events/event-map-auth.js';
+import type { BrainEventMap } from './events/event-map-brain.js';
+import type { CuratorEventMap } from './events/event-map-curator.js';
+import type { EnvironmentsEventMap } from './events/event-map-environments.js';
+import type { McpEventMap } from './events/event-map-mcp.js';
+import type { RuntimeEventMap } from './events/event-map-runtime.js';
+import type { SchedulerEventMap } from './events/event-map-scheduler.js';
+import type { SkillsEventMap } from './events/event-map-skills.js';
+import type { TaskEventMap } from './events/event-map-task.js';
+import type { TuiEventMap } from './events/event-map-tui.js';
+/**
+ * Fields added to every emission by the bridge event emitter. Subscribers
+ * see a `BridgeEventBase & BridgeEventMap[K]` payload.
+ */
+export interface BridgeEventBase {
+    readonly eventVersion: 1;
+    /** `Date.now()` captured at emission time. */
+    readonly timestamp: number;
+}
+/** Typed catalog of all events emitted by the Bridge event bus. */
+export interface BridgeEventMap extends ApprovalEventMap, TaskEventMap, McpEventMap, SkillsEventMap, AuthEventMap, BrainEventMap, RuntimeEventMap, EnvironmentsEventMap, SchedulerEventMap, CuratorEventMap, TuiEventMap {
+}
+/** Delivered payload seen by exact handlers. */
+export type BridgeEventPayload<K extends keyof BridgeEventMap> = BridgeEventBase & BridgeEventMap[K];
+export type BridgeEventHandler<K extends keyof BridgeEventMap> = (event: Readonly<BridgeEventPayload<K>>) => void | Promise<void>;
+export type BridgeEventObject<K extends keyof BridgeEventMap> = Readonly<{
+    type: K;
+    readonly eventVersion: 1;
+    /** Numeric timestamp from `Date.now()` captured at emission time. */
+    timestamp: number;
+    data: Readonly<BridgeEventMap[K]>;
+}>;
+export type BridgeAnyEvent<K extends keyof BridgeEventMap = keyof BridgeEventMap> = K extends keyof BridgeEventMap ? BridgeEventObject<K> : never;
+export type BridgeAnyEventHandler = (event: BridgeAnyEvent) => void | Promise<void>;
+export type AgentRunEventName = `agent:${RunEvent['kind']}`;
+export type { FabricEventContext, OptionalTaskContext, TaskEventContext, } from './events/shared.js';
+//# sourceMappingURL=events-contracts.d.ts.map

package/dist/runtime/bridge/events-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-contracts.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/events-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,WAAW,cACf,SACE,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,WAAW;CAAG;AAElB,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,cAAc,IAC3D,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,cAAc,IAAI,CAC/D,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,KACnC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,cAAc,IAAI,QAAQ,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,cAAc,IACnD,CAAC,SAAS,MAAM,cAAc,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,cAAc,KAClB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,iBAAiB,GAAG,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AAE5D,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/runtime/bridge/events-contracts.js

@@ -0,0 +1 @@
+//# sourceMappingURL=events-contracts.js.map

package/dist/runtime/bridge/events-contracts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/events-schema.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Bridge event schema registry.
+ *
+ * Mirrors the `transport/schemas.ts` pattern: at sensitive boundaries, zod
+ * schemas turn a TS-only contract into a runtime-checked one. Here the
+ * boundary is `BridgeEventEmitter.emit()` — plugins and adapters emit
+ * events, and a shape drift would otherwise surface only at subscriber
+ * runtime.
+ *
+ * Policy:
+ *   * Validation is **opt-in**. It is off by default in production to keep
+ *     the emitter's hot path free of runtime cost.
+ *   * When enabled via `BridgeEventEmitter` option (`validate: true`) or the
+ *     `BRIDGE_EVENT_VALIDATE=1` environment variable, each `emit()` call
+ *     runs the matching schema (if any).
+ *   * Events without a registered schema are passed through unchanged — the
+ *     registry grows incrementally. Core task/backend events ship validated
+ *     from day one.
+ *
+ * Breaking changes to any registered schema must bump
+ * {@link BRIDGE_EVENT_VERSION} (see `./events.ts`).
+ */
+import { z } from 'zod';
+import type { BridgeEventMap } from './events-contracts.js';
+/**
+ * Partial registry of zod schemas for Bridge events. Only critical lifecycle
+ * events are covered here — additional events can be added in future PRs
+ * without a breaking change to the registry shape.
+ */
+export declare const BridgeEventSchemas: Partial<{
+    [K in keyof BridgeEventMap]: z.ZodTypeAny;
+}>;
+/**
+ * Validate an event payload against its registered schema.
+ *
+ * * Returns the parsed payload (identical to input when no schema is
+ *   registered for `event`).
+ * * Throws {@link SchemaValidationError} when the payload does not match.
+ */
+export declare function validateBridgeEvent<K extends keyof BridgeEventMap>(event: K, payload: unknown): BridgeEventMap[K];
+/** Read the env-var that enables validation without a constructor argument. */
+export declare function envValidationEnabled(): boolean;
+//# sourceMappingURL=events-schema.d.ts.map

package/dist/runtime/bridge/events-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-schema.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/events-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA6B5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC;KACtC,CAAC,IAAI,MAAM,cAAc,GAAG,CAAC,CAAC,UAAU;CAC1C,CA4DA,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,cAAc,EAChE,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,OAAO,GACf,cAAc,CAAC,CAAC,CAAC,CAYnB;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C"}