@smooai/smooth-operator-core 0.10.0 → 0.11.0

package/dist/extension/host.js

@@ -0,0 +1,502 @@
+/**
+ * `ExtensionHost` — orchestrates the loaded extensions: hook chaining in load
+ * order, non-blocking event fanout, tool proxies, and the ext→host delegate seam.
+ * The TS sibling of the Rust host's `extension/host.rs`.
+ *
+ * The security-critical part is {@link foldHookChain}: how per-extension hook
+ * outcomes combine, and what happens on timeout/crash. It is a pure function so it
+ * can be tested exhaustively against adversarial inputs without spawning anything.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { defaultGlobalDir, resolvedEnv } from './manifest.js';
+import { ExtensionProcess } from './process.js';
+import { codes, method, parseHookOutcome, PROTOCOL_VERSION, RpcError, } from './protocol.js';
+import { ExtensionTool } from './tool_proxy.js';
+export { PROTOCOL_VERSION };
+const HOOK_TYPES = new Set([
+    'tool_call',
+    'user_bash',
+    'tool_result',
+    'input',
+    'before_agent_start',
+    'context',
+    'before_provider_request',
+    'message_end',
+    'session_before_compact',
+    'session_before_tree',
+]);
+/** The two fail-closed hooks: they gate execution, so a timeout/crash BLOCKS. */
+const FAIL_CLOSED_HOOKS = new Set(['tool_call', 'user_bash']);
+export function hookTypeFromName(name) {
+    return HOOK_TYPES.has(name) ? name : undefined;
+}
+/**
+ * Fail-closed hooks (`tool_call`, `user_bash`) block the operation when an
+ * extension times out or crashes. Everything else fails open (proceeds).
+ */
+export function hookFailClosed(hook) {
+    return FAIL_CLOSED_HOOKS.has(hook);
+}
+/**
+ * Default hook timeout (ms): 60s for fail-closed (they gate execution), 5s for
+ * fail-open. Manifest `hook_timeout_ms` overrides this.
+ */
+export function hookDefaultTimeoutMs(hook) {
+    return hookFailClosed(hook) ? 60_000 : 5_000;
+}
+/**
+ * Fold a hook chain over `input`, in load order. `steps` are the per-extension
+ * results in that order. This is the security-critical policy:
+ *
+ * - `continue` → value unchanged, next extension sees it.
+ * - `modify` → value replaced by the patch, next extension sees the patch.
+ * - `block` → short-circuit; the operation is vetoed (honored for every hook).
+ * - failed → for a fail-closed hook, block; for a fail-open hook, proceed unchanged.
+ */
+export function foldHookChain(hook, input, steps) {
+    let current = input;
+    for (const step of steps) {
+        if (step.kind === 'failed') {
+            if (hookFailClosed(hook))
+                return { kind: 'blocked', reason: `${hook} hook failed (fail-closed)` };
+            // fail-open: proceed with the current value.
+            continue;
+        }
+        const outcome = step.outcome;
+        if (outcome.action === 'continue')
+            continue;
+        if (outcome.action === 'modify') {
+            current = outcome.patch;
+            continue;
+        }
+        // block
+        return { kind: 'blocked', reason: outcome.reason ?? `blocked by ${hook} hook` };
+    }
+    return { kind: 'proceed', value: current };
+}
+/**
+ * Effective event subscriptions: what the extension asked for at handshake,
+ * clamped to what its manifest `[capabilities] events` declared. An empty declared
+ * list means "no declared filter" → trust the handshake as-is; a non-empty list is
+ * the outer bound the extension can never widen past.
+ */
+export function effectiveSubscriptions(declared, requested) {
+    if (declared.length === 0)
+        return new Set(requested);
+    const allow = new Set(declared);
+    return new Set(requested.filter((s) => allow.has(s)));
+}
+/** Parse the epoch embedded in a context token minted by {@link ExtensionHost.context} (`epoch-<N>`). */
+function tokenEpoch(token) {
+    if (!token.startsWith('epoch-'))
+        return undefined;
+    const n = token.slice('epoch-'.length);
+    if (n.length === 0 || !/^\d+$/.test(n))
+        return undefined;
+    return Number(n);
+}
+/**
+ * The two-tier deadlock guard: a session-mutating ext→host action is valid only
+ * when it presents a COMMAND-tier context whose epoch is still current. An
+ * event-tier context, or a stale token minted before a reload bumped the epoch, is
+ * rejected with `-32003 ContextViolation`. Security-critical; a pure function so it
+ * can be tested exhaustively.
+ */
+export function validateCommandContext(params, currentEpoch) {
+    const ctx = params?.context;
+    if (ctx?.tier !== 'command')
+        throw new RpcError(codes.ContextViolation, 'session action requires a command-tier context');
+    const token = typeof ctx.token === 'string' ? ctx.token : '';
+    const epoch = tokenEpoch(token);
+    if (epoch === undefined || epoch !== currentEpoch) {
+        throw new RpcError(codes.ContextViolation, 'session action presented a stale context (epoch mismatch)');
+    }
+}
+/** Per-extension kv state file: `<globalDir>/<name>/state.json`. */
+function kvFilePath(ext) {
+    const dir = defaultGlobalDir();
+    return dir ? join(dir, ext, 'state.json') : undefined;
+}
+function kvFileLoad(ext) {
+    const path = kvFilePath(ext);
+    if (!path || !existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function kvFileStore(ext, map) {
+    const path = kvFilePath(ext);
+    if (!path)
+        throw new RpcError(codes.InternalError, 'no home dir for kv store');
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(map, null, 2));
+}
+/** The engine's headless delegate: NoUI, JSON-file kv, exec denied, session disabled. */
+export class DefaultHostDelegate {
+    async uiRequest(_ext, _params) {
+        throw new RpcError(codes.NoUI, 'no UI available (headless host)');
+    }
+    async kvGet(ext, key) {
+        return kvFileLoad(ext)[key] ?? null;
+    }
+    async kvSet(ext, key, value) {
+        const map = kvFileLoad(ext);
+        map[key] = value;
+        kvFileStore(ext, map);
+    }
+    async execRun(_ext, _params) {
+        throw new RpcError(codes.NotTrusted, 'exec/run is not permitted on the headless host');
+    }
+    async sessionSendMessage(_ext, _params) {
+        throw new RpcError(codes.CapabilityDisabled, 'session actions are unavailable on this host');
+    }
+    async sessionSendUserMessage(_ext, _params) {
+        throw new RpcError(codes.CapabilityDisabled, 'session actions are unavailable on this host');
+    }
+    async sessionAppendEntry(_ext, _params) {
+        throw new RpcError(codes.CapabilityDisabled, 'session actions are unavailable on this host');
+    }
+    toolUpdate(_ext, _params) {
+        // Headless: progress is dropped. A frontend/daemon overrides this.
+    }
+}
+/**
+ * Bridges the process reader's ext→host requests to the {@link HostDelegate}.
+ * Holds a getter for the host's live epoch so it can reject stale/event-tier
+ * session actions.
+ */
+class HostInbound {
+    ext;
+    delegate;
+    currentEpoch;
+    constructor(ext, delegate, currentEpoch) {
+        this.ext = ext;
+        this.delegate = delegate;
+        this.currentEpoch = currentEpoch;
+    }
+    async handleRequest(methodName, params) {
+        switch (methodName) {
+            case method.PING:
+                return {};
+            case method.UI_REQUEST:
+                return this.delegate.uiRequest(this.ext, params);
+            case method.EXEC_RUN:
+                return this.delegate.execRun(this.ext, params);
+            // Session actions are the tier-guarded set: validate the presented
+            // context (command tier + current epoch) BEFORE touching the delegate.
+            case method.SESSION_SEND_MESSAGE:
+                validateCommandContext(params, this.currentEpoch());
+                return this.delegate.sessionSendMessage(this.ext, params);
+            case method.SESSION_SEND_USER_MESSAGE:
+                validateCommandContext(params, this.currentEpoch());
+                return this.delegate.sessionSendUserMessage(this.ext, params);
+            case method.SESSION_APPEND_ENTRY:
+                validateCommandContext(params, this.currentEpoch());
+                return this.delegate.sessionAppendEntry(this.ext, params);
+            case 'kv/get': {
+                const key = params?.key;
+                return { value: await this.delegate.kvGet(this.ext, typeof key === 'string' ? key : '') };
+            }
+            case 'kv/set': {
+                const p = params;
+                await this.delegate.kvSet(this.ext, typeof p?.key === 'string' ? p.key : '', p?.value ?? null);
+                return {};
+            }
+            default:
+                throw new RpcError(codes.MethodNotFound, `method not found: ${methodName}`);
+        }
+    }
+    handleNotification(methodName, params) {
+        if (methodName === method.TOOL_UPDATE)
+            this.delegate.toolUpdate(this.ext, params);
+    }
+}
+/** Orchestrates the set of loaded extensions in load order. */
+export class ExtensionHost {
+    host;
+    workspace;
+    mode;
+    uiCapabilities;
+    extensions = [];
+    epoch = 1;
+    constructor(host, workspace, mode, uiCapabilities) {
+        this.host = host;
+        this.workspace = workspace;
+        this.mode = mode;
+        this.uiCapabilities = uiCapabilities;
+    }
+    /** An empty host: no extensions, every hook a passthrough. The zero-cost default. */
+    static empty() {
+        return new ExtensionHost({ name: 'smooth-operator-core', version: '0.0.0' }, { root: '', trusted: false }, 'headless', []);
+    }
+    /**
+     * Load and initialize each discovered extension. Per-extension failures (spawn,
+     * handshake) are tolerated and returned alongside the host. In an untrusted
+     * workspace, project-scoped extensions are skipped.
+     */
+    static async load(discovered, host, workspace, mode, uiCapabilities, delegate) {
+        const self = new ExtensionHost(host, workspace, mode, uiCapabilities);
+        const failures = [];
+        for (const ext of discovered) {
+            const name = ext.manifest.name;
+            if (ext.manifest.disabled)
+                continue;
+            if (ext.scope === 'project' && !workspace.trusted)
+                continue;
+            try {
+                self.extensions.push(await self.loadOne(ext, delegate));
+            }
+            catch (e) {
+                failures.push([name, e instanceof Error ? e.message : String(e)]);
+            }
+        }
+        return { host: self, failures };
+    }
+    async loadOne(ext, delegate) {
+        const { manifest, root } = ext;
+        const spec = {
+            command: manifest.run.command,
+            args: manifest.run.args,
+            env: resolvedEnv(manifest),
+            cwd: root,
+        };
+        const handler = new HostInbound(manifest.name, delegate, () => this.epoch);
+        const proc = ExtensionProcess.spawn(spec, handler);
+        const init = await this.initialize(proc);
+        const subscriptions = effectiveSubscriptions(manifest.capabilities.events, init.registrations?.subscriptions ?? []);
+        return {
+            name: manifest.name,
+            process: proc,
+            init,
+            subscriptions,
+            declaredEvents: manifest.capabilities.events,
+            hookTimeoutMs: manifest.hookTimeoutMs,
+        };
+    }
+    /** Send `initialize` and parse the registrations. Shared by load and reload. */
+    async initialize(proc) {
+        const params = {
+            protocol_version: PROTOCOL_VERSION,
+            host: this.host,
+            workspace: this.workspace,
+            mode: this.mode,
+            ui_capabilities: this.uiCapabilities,
+            flags: {},
+        };
+        const raw = (await proc.request(method.INITIALIZE, params, 10_000));
+        if (typeof raw?.protocol_version !== 'number' || typeof raw?.extension?.name !== 'string') {
+            throw new Error('bad initialize result');
+        }
+        return raw;
+    }
+    /** Number of successfully loaded extensions. */
+    get length() {
+        return this.extensions.length;
+    }
+    isEmpty() {
+        return this.extensions.length === 0;
+    }
+    /** Names of loaded extensions, in load order. */
+    names() {
+        return this.extensions.map((e) => e.name);
+    }
+    /**
+     * A fresh dispatch context. Session-mutating actions need `command` tier. The
+     * token embeds the current epoch so it is invalidated across reloads.
+     */
+    context(tier) {
+        return { token: `epoch-${this.epoch}`, tier };
+    }
+    /** Bump the epoch, invalidating every previously minted context token. */
+    bumpEpoch() {
+        this.epoch++;
+    }
+    /** True if any loaded extension subscribed to `event`. */
+    hasSubscriber(event) {
+        return this.extensions.some((e) => e.subscriptions.has(event));
+    }
+    /**
+     * Fire-and-forget event fanout to every subscribed extension. Non-blocking: a
+     * slow or dead extension never stalls the caller (bounded, lossy observe lane).
+     */
+    dispatchEvent(event, payload) {
+        if (this.extensions.length === 0)
+            return;
+        const ctx = this.context('event');
+        for (const ext of this.extensions) {
+            if (!ext.subscriptions.has(event))
+                continue;
+            ext.process.sendEvent(event, ctx, payload);
+        }
+    }
+    /**
+     * Run a hook across every extension in load order, folding the chain. Each
+     * extension sees the prior extension's patch. Fail-open/closed per hook type.
+     */
+    async runHook(hook, input) {
+        if (this.extensions.length === 0)
+            return { kind: 'proceed', value: input };
+        const ctx = this.context('command');
+        let current = input;
+        for (const ext of this.extensions) {
+            const params = { hook, context: ctx, input: current };
+            const timeout = ext.hookTimeoutMs ?? hookDefaultTimeoutMs(hook);
+            let step;
+            try {
+                const value = await ext.process.request(method.HOOK, params, timeout);
+                try {
+                    step = { kind: 'replied', outcome: parseHookOutcome(value) };
+                }
+                catch {
+                    step = { kind: 'failed' };
+                }
+            }
+            catch {
+                step = { kind: 'failed' };
+            }
+            const folded = foldHookChain(hook, current, [step]);
+            if (folded.kind === 'blocked')
+                return folded;
+            current = folded.value;
+        }
+        return { kind: 'proceed', value: current };
+    }
+    /** Convenience: run the `tool_call` hook (fail-closed) on a pending call. */
+    runToolCallHook(tool, args) {
+        return this.runHook('tool_call', { tool, arguments: args });
+    }
+    /**
+     * Run the `before_agent_start` hook on a system prompt, returning the
+     * possibly-rewritten prompt. Fail-open: a blocked/failed hook leaves it unchanged.
+     */
+    async beforeAgentStart(systemPrompt) {
+        if (this.extensions.length === 0)
+            return systemPrompt;
+        const folded = await this.runHook('before_agent_start', { system_prompt: systemPrompt });
+        if (folded.kind === 'blocked')
+            return systemPrompt;
+        const v = folded.value?.system_prompt;
+        return typeof v === 'string' ? v : systemPrompt;
+    }
+    /**
+     * Tool proxies for every eager tool every extension registered. Names are dotted
+     * `<ext>.<tool>`. Deferred tools are returned by {@link deferredTools}.
+     */
+    tools() {
+        return this.collectTools(false);
+    }
+    /** Deferred tool proxies. */
+    deferredTools() {
+        return this.collectTools(true);
+    }
+    collectTools(deferred) {
+        const ctx = this.context('command');
+        const out = [];
+        for (const ext of this.extensions) {
+            for (const reg of ext.init.registrations?.tools ?? []) {
+                if ((reg.deferred ?? false) !== deferred)
+                    continue;
+                out.push(new ExtensionTool(ext.name, reg, ext.process, ctx));
+            }
+        }
+        return out;
+    }
+    /**
+     * Eager tool proxies for a single extension, minted at the CURRENT epoch. The
+     * frontend calls this after a {@link reload} to re-register the reloaded
+     * extension's tools (its old proxies carry a stale context).
+     */
+    toolsFor(extName) {
+        const ctx = this.context('command');
+        const ext = this.extensions.find((e) => e.name === extName);
+        if (!ext)
+            return [];
+        return (ext.init.registrations?.tools ?? []).filter((reg) => !(reg.deferred ?? false)).map((reg) => new ExtensionTool(ext.name, reg, ext.process, ctx));
+    }
+    /** Every registered slash-command across all extensions, paired with the owning extension name. */
+    commands() {
+        const out = [];
+        for (const ext of this.extensions) {
+            for (const cmd of ext.init.registrations?.commands ?? [])
+                out.push([ext.name, cmd]);
+        }
+        return out;
+    }
+    /** Every keyboard shortcut across all extensions, paired with the owning extension name. */
+    shortcuts() {
+        const out = [];
+        for (const ext of this.extensions) {
+            for (const sc of ext.init.registrations?.shortcuts ?? [])
+                out.push([ext.name, sc]);
+        }
+        return out;
+    }
+    commandOwner(extName, command) {
+        for (const ext of this.extensions) {
+            if (extName !== undefined && extName !== ext.name)
+                continue;
+            if ((ext.init.registrations?.commands ?? []).some((c) => c.name === command))
+                return ext.process;
+        }
+        return undefined;
+    }
+    /**
+     * Dispatch a registered slash-command to its owning extension with a COMMAND-tier
+     * context. Pass `extName` to disambiguate a command registered by more than one
+     * extension; `undefined` picks the first match in load order.
+     */
+    async runCommand(extName, command, args) {
+        const proc = this.commandOwner(extName, command);
+        if (!proc)
+            throw new RpcError(codes.MethodNotFound, `no extension registered command \`${command}\``);
+        const params = { command, context: this.context('command'), arguments: args };
+        return (await proc.request(method.COMMAND_EXECUTE, params, 120_000));
+    }
+    /**
+     * Ask the extension that owns `command` for argument completions given the
+     * `partial` text typed so far. Returns an empty list on error (best-effort —
+     * never fail the caller's keystroke).
+     */
+    async completeCommand(extName, command, partial) {
+        const proc = this.commandOwner(extName, command);
+        if (!proc)
+            return [];
+        const params = { command, context: this.context('command'), partial };
+        try {
+            const raw = (await proc.request(method.COMMAND_COMPLETE, params, 5_000));
+            return raw?.completions ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Hot-reload a single extension by name: notify it (`session_shutdown` reason
+     * `reload`), bump the epoch so every context token it still holds is invalidated,
+     * respawn its subprocess (the generation guard discards any late reply), re-run
+     * `initialize`, then notify it (`session_start` reason `reload`). The caller
+     * re-registers the extension's tools via {@link toolsFor}.
+     */
+    async reload(name) {
+        const ext = this.extensions.find((e) => e.name === name);
+        if (!ext)
+            throw new Error(`extension \`${name}\` is not loaded`);
+        ext.process.sendEvent('session_shutdown', this.context('event'), { reason: 'reload' });
+        this.bumpEpoch();
+        ext.process.respawn();
+        const init = await this.initialize(ext.process);
+        ext.subscriptions = effectiveSubscriptions(ext.declaredEvents, init.registrations?.subscriptions ?? []);
+        ext.init = init;
+        ext.process.sendEvent('session_start', this.context('event'), { reason: 'reload' });
+    }
+    /** Gracefully shut down every extension (5s grace each, then SIGKILL). */
+    async shutdownAll() {
+        await Promise.all(this.extensions.map((e) => e.process.shutdown(5_000)));
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/extension/host.js.map

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

package/dist/extension/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SEP host — the engine's implementation of the Smooth Extension Protocol.
+ *
+ * An extension is a long-lived subprocess speaking JSON-RPC 2.0 over ndjson on its
+ * stdio (identical framing to MCP stdio). The canonical wire schemas live in the
+ * `smooth-operator` repo at `spec/extension/`; {@link module:protocol} is this
+ * host's typed view of that wire. The TS sibling of the Rust reference host at
+ * `rust/smooth-operator-core/src/extension/`.
+ *
+ * Purely additive: nothing here runs unless a caller builds an {@link ExtensionHost}
+ * and registers its {@link ExtensionHost.tools} into an agent. With no host built,
+ * the agent loop behaves exactly as before.
+ */
+export * from './protocol.js';
+export * from './manifest.js';
+export { backoffFor, DefaultInboundHandler, ExtensionProcess, type InboundHandler, OBSERVE_QUEUE_CAP, PING_IDLE_MS, RESTART_BACKOFFS_MS, type SpawnSpec, } from './process.js';
+export { DefaultHostDelegate, effectiveSubscriptions, ExtensionHost, foldHookChain, type FoldedHook, hookDefaultTimeoutMs, hookFailClosed, type HostDelegate, type HookStep, type HookType, hookTypeFromName, type LoadFailure, validateCommandContext, } from './host.js';
+export { ExtensionTool, TOOL_EXECUTE_TIMEOUT_MS } from './tool_proxy.js';
+/**
+ * Canonical SEP event names the host dispatches to subscribed extensions. A
+ * stringly-typed name is the wire contract; the engine's own event producers map
+ * onto these.
+ */
+export declare const events: {
+    readonly TURN_START: "turn_start";
+    readonly TURN_END: "turn_end";
+    readonly MESSAGE_START: "message_start";
+    readonly MESSAGE_UPDATE: "message_update";
+    readonly MESSAGE_END: "message_end";
+    readonly TOOL_EXECUTION_START: "tool_execution_start";
+    readonly TOOL_EXECUTION_UPDATE: "tool_execution_update";
+    readonly TOOL_EXECUTION_END: "tool_execution_end";
+    /** Delivered when the bounded observe queue shed events. Carries `{lost: N}`. */
+    readonly EVENTS_LOST: "events_lost";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extension/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,OAAO,EACH,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,cAAc,EACnB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,KAAK,SAAS,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,KAAK,UAAU,EACf,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,gBAAgB,EAChB,KAAK,WAAW,EAChB,sBAAsB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;;;;;;;IAUf,iFAAiF;;CAE3E,CAAC"}

package/dist/extension/index.js

@@ -0,0 +1,37 @@
+/**
+ * SEP host — the engine's implementation of the Smooth Extension Protocol.
+ *
+ * An extension is a long-lived subprocess speaking JSON-RPC 2.0 over ndjson on its
+ * stdio (identical framing to MCP stdio). The canonical wire schemas live in the
+ * `smooth-operator` repo at `spec/extension/`; {@link module:protocol} is this
+ * host's typed view of that wire. The TS sibling of the Rust reference host at
+ * `rust/smooth-operator-core/src/extension/`.
+ *
+ * Purely additive: nothing here runs unless a caller builds an {@link ExtensionHost}
+ * and registers its {@link ExtensionHost.tools} into an agent. With no host built,
+ * the agent loop behaves exactly as before.
+ */
+export * from './protocol.js';
+export * from './manifest.js';
+export { backoffFor, DefaultInboundHandler, ExtensionProcess, OBSERVE_QUEUE_CAP, PING_IDLE_MS, RESTART_BACKOFFS_MS, } from './process.js';
+export { DefaultHostDelegate, effectiveSubscriptions, ExtensionHost, foldHookChain, hookDefaultTimeoutMs, hookFailClosed, hookTypeFromName, validateCommandContext, } from './host.js';
+export { ExtensionTool, TOOL_EXECUTE_TIMEOUT_MS } from './tool_proxy.js';
+/**
+ * Canonical SEP event names the host dispatches to subscribed extensions. A
+ * stringly-typed name is the wire contract; the engine's own event producers map
+ * onto these.
+ */
+export const events = {
+    TURN_START: 'turn_start',
+    TURN_END: 'turn_end',
+    MESSAGE_START: 'message_start',
+    MESSAGE_UPDATE: 'message_update',
+    MESSAGE_END: 'message_end',
+    // Names mirror pi's `tool_execution_*` so pi extensions port unchanged.
+    TOOL_EXECUTION_START: 'tool_execution_start',
+    TOOL_EXECUTION_UPDATE: 'tool_execution_update',
+    TOOL_EXECUTION_END: 'tool_execution_end',
+    /** Delivered when the bounded observe queue shed events. Carries `{lost: N}`. */
+    EVENTS_LOST: 'events_lost',
+};
+//# sourceMappingURL=index.js.map

package/dist/extension/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extension/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,OAAO,EACH,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAEhB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GAEtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,aAAa,EAEb,oBAAoB,EACpB,cAAc,EAId,gBAAgB,EAEhB,sBAAsB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,wEAAwE;IACxE,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,iFAAiF;IACjF,WAAW,EAAE,aAAa;CACpB,CAAC"}