@smooai/smooth-operator-core 0.10.0 → 0.10.1

package/dist/extension/protocol.js

@@ -0,0 +1,127 @@
+/**
+ * SEP wire protocol — JSON-RPC 2.0 frames and typed method params/results.
+ *
+ * SEP (the Smooth Extension Protocol) is JSON-RPC 2.0 over ndjson on an extension
+ * subprocess's stdio. The canonical schemas live in the `smooth-operator` repo at
+ * `spec/extension/`; the types here are the TS engine host's view of that wire —
+ * the sibling of the Rust host's `extension/protocol.rs`. Field names are
+ * `snake_case` because they ARE the wire.
+ *
+ * The author-side `@smooai/smooth-extension-sdk` ships its own copy of these
+ * shapes; the host keeps them local rather than importing the SDK, which would
+ * invert the dependency (the engine is the lower layer the SDK's host consumers
+ * build on).
+ */
+/** The SEP protocol version this host implements. Effective = min(host, ext). */
+export const PROTOCOL_VERSION = 1;
+/** SEP method names, centralized so the host and tests never spell one wrong. */
+export const method = {
+    INITIALIZE: 'initialize',
+    SHUTDOWN: 'shutdown',
+    PING: 'ping',
+    EVENT: 'event',
+    HOOK: 'hook',
+    TOOL_EXECUTE: 'tool/execute',
+    TOOL_UPDATE: 'tool/update',
+    COMMAND_EXECUTE: 'command/execute',
+    COMMAND_COMPLETE: 'command/complete',
+    CANCEL: '$/cancel',
+    REGISTRY_UPDATE: 'registry/update',
+    TOOLS_SET_ACTIVE: 'tools/set_active',
+    EXEC_RUN: 'exec/run',
+    UI_REQUEST: 'ui/request',
+    LOG: 'log',
+    BUS_PUBLISH: 'bus/publish',
+    SESSION_SEND_MESSAGE: 'session/send_message',
+    SESSION_SEND_USER_MESSAGE: 'session/send_user_message',
+    SESSION_APPEND_ENTRY: 'session/append_entry',
+};
+/**
+ * JSON-RPC + SEP error codes (see `spec/extension/envelope.md`). Standard range
+ * plus the SEP extensions.
+ */
+export const codes = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    /** A hook or policy vetoed the operation. */
+    Blocked: -32000,
+    /** `ui/request` in a headless/uncapable frontend. */
+    NoUI: -32001,
+    /** Extension acted beyond its granted trust. */
+    NotTrusted: -32002,
+    /** Command-tier action attempted from an event-tier context. */
+    ContextViolation: -32003,
+    /** Method requires a capability the handshake did not enable. */
+    CapabilityDisabled: -32004,
+    /** Request cancelled via `$/cancel`. */
+    Cancelled: -32800,
+};
+/** An error carrying a JSON-RPC error code, thrown/returned for a remote error. */
+export class RpcError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'RpcError';
+    }
+    toObject() {
+        return this.data === undefined ? { code: this.code, message: this.message } : { code: this.code, message: this.message, data: this.data };
+    }
+}
+/** Build a request frame. */
+export function request(id, methodName, params) {
+    return { jsonrpc: '2.0', id, method: methodName, params };
+}
+/** Build a notification frame (no id, no reply expected). */
+export function notification(methodName, params) {
+    return { jsonrpc: '2.0', method: methodName, params };
+}
+/** Build a success response frame echoing `id`. */
+export function success(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+/** Build an error response frame echoing `id`. */
+export function errorResponse(id, error) {
+    return { jsonrpc: '2.0', id, error };
+}
+/** True when this frame is a request (has both `id` and `method`). */
+export function isRequest(m) {
+    return m.id !== undefined && m.id !== null && m.method !== undefined;
+}
+/** True when this frame is a notification (has `method`, no `id`). */
+export function isNotification(m) {
+    return (m.id === undefined || m.id === null) && m.method !== undefined;
+}
+/** True when this frame is a response (has `id`, no `method`). */
+export function isResponse(m) {
+    return m.method === undefined && m.id !== undefined && m.id !== null;
+}
+/**
+ * Parse an untyped `hook` reply into a {@link HookOutcome}, or throw when it is
+ * malformed. Mirrors the Rust host's serde-tagged decode: a `modify` without a
+ * `patch`, or an unknown `action`, is rejected (the host then treats it as a
+ * failed hook step).
+ */
+export function parseHookOutcome(value) {
+    if (typeof value !== 'object' || value === null)
+        throw new RpcError(codes.InvalidParams, 'hook outcome is not an object');
+    const action = value.action;
+    if (action === 'continue')
+        return { action: 'continue' };
+    if (action === 'block') {
+        const reason = value.reason;
+        return typeof reason === 'string' ? { action: 'block', reason } : { action: 'block' };
+    }
+    if (action === 'modify') {
+        if (!('patch' in value))
+            throw new RpcError(codes.InvalidParams, "hook 'modify' outcome missing patch");
+        return { action: 'modify', patch: value.patch };
+    }
+    throw new RpcError(codes.InvalidParams, `unknown hook action: ${String(action)}`);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/extension/protocol.js.map

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

package/dist/extension/tool_proxy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `ExtensionTool` — a core {@link Tool} backed by an extension subprocess. The TS
+ * sibling of the Rust host's `extension/tool_proxy.rs`.
+ *
+ * Registered tools appear to the agent as ordinary tools named `<extension>.<tool>`
+ * (the MCP convention). `execute` forwards to the extension over `tool/execute` and
+ * maps the reply back to a result string.
+ */
+import type { Tool } from '../agent.js';
+import type { ExtensionProcess } from './process.js';
+import { type Context } from './protocol.js';
+/**
+ * Upper bound (ms) for a single `tool/execute` round-trip. The agent applies its
+ * own per-tool timeout too; whichever is shorter wins in practice.
+ */
+export declare const TOOL_EXECUTE_TIMEOUT_MS = 120000;
+/** A tool exposed by an extension, adapted to the engine's {@link Tool} seam. */
+export declare class ExtensionTool implements Tool {
+    private readonly process;
+    private readonly context;
+    /** `<extension>.<tool>` — what the agent/LLM sees. */
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: Record<string, unknown>;
+    /** Bare tool name sent to the extension. */
+    private readonly bareName;
+    constructor(extName: string, reg: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }, process: ExtensionProcess, context: Context);
+    execute(args: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=tool_proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool_proxy.d.ts","sourceRoot":"","sources":["../../src/extension/tool_proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,KAAK,OAAO,EAAkC,MAAM,eAAe,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,iFAAiF;AACjF,qBAAa,aAAc,YAAW,IAAI;IAWlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAG9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAC9D,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,OAAO;IAQ/B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAWhE"}

package/dist/extension/tool_proxy.js

@@ -0,0 +1,48 @@
+/**
+ * `ExtensionTool` — a core {@link Tool} backed by an extension subprocess. The TS
+ * sibling of the Rust host's `extension/tool_proxy.rs`.
+ *
+ * Registered tools appear to the agent as ordinary tools named `<extension>.<tool>`
+ * (the MCP convention). `execute` forwards to the extension over `tool/execute` and
+ * maps the reply back to a result string.
+ */
+import { randomUUID } from 'node:crypto';
+import { method } from './protocol.js';
+/**
+ * Upper bound (ms) for a single `tool/execute` round-trip. The agent applies its
+ * own per-tool timeout too; whichever is shorter wins in practice.
+ */
+export const TOOL_EXECUTE_TIMEOUT_MS = 120_000;
+/** A tool exposed by an extension, adapted to the engine's {@link Tool} seam. */
+export class ExtensionTool {
+    process;
+    context;
+    /** `<extension>.<tool>` — what the agent/LLM sees. */
+    name;
+    description;
+    parameters;
+    /** Bare tool name sent to the extension. */
+    bareName;
+    constructor(extName, reg, process, context) {
+        this.process = process;
+        this.context = context;
+        this.name = `${extName}.${reg.name}`;
+        this.bareName = reg.name;
+        this.description = reg.description;
+        this.parameters = reg.parameters;
+    }
+    async execute(args) {
+        const callId = randomUUID();
+        const params = { call_id: callId, tool: this.bareName, arguments: args, context: this.context };
+        const raw = (await this.process.request(method.TOOL_EXECUTE, params, TOOL_EXECUTE_TIMEOUT_MS));
+        if (typeof raw?.content !== 'string')
+            throw new Error('malformed tool/execute result: missing content');
+        if (raw.is_error)
+            throw new Error(raw.content);
+        // ponytail: `details` is dropped here — Tool.execute returns only a string.
+        // Surfacing structured details rides on tool-update/event wiring in a later
+        // phase; the field is preserved on ToolExecuteResult already.
+        return raw.content;
+    }
+}
+//# sourceMappingURL=tool_proxy.js.map

package/dist/extension/tool_proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_proxy.js","sourceRoot":"","sources":["../../src/extension/tool_proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAgB,MAAM,EAA0B,MAAM,eAAe,CAAC;AAE7E;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,iFAAiF;AACjF,MAAM,OAAO,aAAa;IAWD;IACA;IAXrB,sDAAsD;IAC7C,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,UAAU,CAA0B;IAC7C,4CAA4C;IAC3B,QAAQ,CAAS;IAElC,YACI,OAAe,EACf,GAA+E,EAC9D,OAAyB,EACzB,OAAgB;QADhB,YAAO,GAAP,OAAO,CAAkB;QACzB,YAAO,GAAP,OAAO,CAAS;QAEjC,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACvC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChG,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,uBAAuB,CAAC,CAAsB,CAAC;QACpH,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACxG,IAAI,GAAG,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,4EAA4E;QAC5E,4EAA4E;QAC5E,8DAA8D;QAC9D,OAAO,GAAG,CAAC,OAAO,CAAC;IACvB,CAAC;CACJ"}

package/dist/humanGate.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Human-in-the-loop approval — pause before a sensitive/write tool runs.
+ *
+ * Phase-2 sibling of the C# `HumanGate` (`dotnet/core`) and the Rust engine's
+ * confirmation hook. When a turn is about to run a tool the caller flagged as
+ * needing approval, the agent consults a {@link HumanGate} first. The gate IS the
+ * pause point — a UI gate awaits a real person (e.g. resolving a promise when a
+ * button is clicked); a programmatic gate decides immediately. A denial is never
+ * executed; the denial reason is fed back to the model as the tool result so the
+ * model can adapt. With no gate configured, behavior is unchanged.
+ */
+/** The human's verdict on a tool call that required approval. */
+export declare enum HumanDecision {
+    Approved = "approved",
+    Denied = "denied"
+}
+/**
+ * A request for human approval before the agent executes a sensitive/write tool.
+ * Mirrors the C# `HumanApprovalRequest` / the Rust engine's `HumanRequest::Confirm`.
+ */
+export interface HumanApprovalRequest {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    prompt: string;
+}
+/** The response to a {@link HumanApprovalRequest}. Mirrors the C# `HumanApprovalResponse`. */
+export interface HumanApprovalResponse {
+    decision: HumanDecision;
+    reason?: string;
+}
+/** True when the decision is {@link HumanDecision.Approved}. */
+export declare function isApproved(response: HumanApprovalResponse): boolean;
+/** Build an approval. */
+export declare function approve(): HumanApprovalResponse;
+/** Build a denial carrying a reason the model will see. */
+export declare function deny(reason: string): HumanApprovalResponse;
+/**
+ * The human-in-the-loop seam: the agent consults it before running any tool that
+ * {@link AgentOptions.requiresApproval} flags. The implementation IS the pause
+ * point — wire it to a UI awaiting a real person, or decide programmatically.
+ * Mirrors the C# `IHumanGate` (here just an async function, the idiomatic TS seam).
+ */
+export type HumanGate = (request: HumanApprovalRequest) => Promise<HumanApprovalResponse>;
+//# sourceMappingURL=humanGate.d.ts.map

package/dist/humanGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"humanGate.d.ts","sourceRoot":"","sources":["../src/humanGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iEAAiE;AACjE,oBAAY,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAEnE;AAED,yBAAyB;AACzB,wBAAgB,OAAO,IAAI,qBAAqB,CAE/C;AAED,2DAA2D;AAC3D,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAE1D;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/humanGate.js

@@ -0,0 +1,30 @@
+/**
+ * Human-in-the-loop approval — pause before a sensitive/write tool runs.
+ *
+ * Phase-2 sibling of the C# `HumanGate` (`dotnet/core`) and the Rust engine's
+ * confirmation hook. When a turn is about to run a tool the caller flagged as
+ * needing approval, the agent consults a {@link HumanGate} first. The gate IS the
+ * pause point — a UI gate awaits a real person (e.g. resolving a promise when a
+ * button is clicked); a programmatic gate decides immediately. A denial is never
+ * executed; the denial reason is fed back to the model as the tool result so the
+ * model can adapt. With no gate configured, behavior is unchanged.
+ */
+/** The human's verdict on a tool call that required approval. */
+export var HumanDecision;
+(function (HumanDecision) {
+    HumanDecision["Approved"] = "approved";
+    HumanDecision["Denied"] = "denied";
+})(HumanDecision || (HumanDecision = {}));
+/** True when the decision is {@link HumanDecision.Approved}. */
+export function isApproved(response) {
+    return response.decision === HumanDecision.Approved;
+}
+/** Build an approval. */
+export function approve() {
+    return { decision: HumanDecision.Approved };
+}
+/** Build a denial carrying a reason the model will see. */
+export function deny(reason) {
+    return { decision: HumanDecision.Denied, reason };
+}
+//# sourceMappingURL=humanGate.js.map

package/dist/humanGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"humanGate.js","sourceRoot":"","sources":["../src/humanGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iEAAiE;AACjE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;AACrB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAkBD,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,QAA+B;IACtD,OAAO,QAAQ,CAAC,QAAQ,KAAK,aAAa,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,OAAO;IACnB,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,IAAI,CAAC,MAAc;IAC/B,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @smooai/smooth-operator-core — a native, in-process agent engine for TypeScript.
+ *
+ * The Phase-0 TypeScript sibling of the Rust reference engine, the C# core, and
+ * the Python core: an agentic tool-calling loop over any OpenAI-compatible chat
+ * client, with in-memory knowledge grounding. See `docs/Architecture/TypeScript Core.md`.
+ */
+export { delegateTool, SmoothAgent } from './agent.js';
+export type { AgentOptions, AgentRunResponse, ChatChunk, ChatClientLike, StreamEvent, Tool } from './agent.js';
+export { Cast, Clearance, makeRole, RoleKind } from './cast.js';
+export type { OperatorRole } from './cast.js';
+export { InMemoryCheckpointStore } from './checkpoint.js';
+export type { Checkpoint, CheckpointStore } from './checkpoint.js';
+export { CostTracker, DEFAULT_PRICING } from './cost.js';
+export type { CostBudget, ModelPricing, Usage } from './cost.js';
+export { approve, deny, HumanDecision, isApproved } from './humanGate.js';
+export type { HumanApprovalRequest, HumanApprovalResponse, HumanGate } from './humanGate.js';
+export { InMemoryKnowledge } from './knowledge.js';
+export type { Knowledge, KnowledgeHit } from './knowledge.js';
+export { MockLlmProvider, textResponse, toolCallResponse } from './llmProvider.js';
+export type { LlmProvider, RecordedCall, ScriptedMessage, ScriptedUsage } from './llmProvider.js';
+export { InMemoryMemory } from './memory.js';
+export type { Memory, MemoryEntry } from './memory.js';
+export { LexicalReranker, NoopReranker } from './rerank.js';
+export type { Reranker } from './rerank.js';
+export { SmoothAgentThread } from './thread.js';
+export { MAX_MATCHES, TOOL_SEARCH_NAME, ToolSearch } from './toolSearch.js';
+export { HashEmbedder, hashToken, VectorKnowledge } from './vector.js';
+export type { Embedder } from './vector.js';
+export { END, Workflow, WorkflowError } from './workflow.js';
+export type { NodeFn, Router } from './workflow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @smooai/smooth-operator-core — a native, in-process agent engine for TypeScript.
+ *
+ * The Phase-0 TypeScript sibling of the Rust reference engine, the C# core, and
+ * the Python core: an agentic tool-calling loop over any OpenAI-compatible chat
+ * client, with in-memory knowledge grounding. See `docs/Architecture/TypeScript Core.md`.
+ */
+export { delegateTool, SmoothAgent } from './agent.js';
+export { Cast, Clearance, makeRole, RoleKind } from './cast.js';
+export { InMemoryCheckpointStore } from './checkpoint.js';
+export { CostTracker, DEFAULT_PRICING } from './cost.js';
+export { approve, deny, HumanDecision, isApproved } from './humanGate.js';
+export { InMemoryKnowledge } from './knowledge.js';
+export { MockLlmProvider, textResponse, toolCallResponse } from './llmProvider.js';
+export { InMemoryMemory } from './memory.js';
+export { LexicalReranker, NoopReranker } from './rerank.js';
+export { SmoothAgentThread } from './thread.js';
+export { MAX_MATCHES, TOOL_SEARCH_NAME, ToolSearch } from './toolSearch.js';
+export { HashEmbedder, hashToken, VectorKnowledge } from './vector.js';
+export { END, Workflow, WorkflowError } from './workflow.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/knowledge.d.ts

@@ -0,0 +1,30 @@
+/**
+ * In-memory knowledge base for the TypeScript smooth-operator core.
+ *
+ * A minimal lexical-overlap retriever — the Phase-0 sibling of the Rust engine's
+ * in-memory lexical store and the Python core's `InMemoryKnowledge`. Documents
+ * are scored by token overlap with the query; the top-k are returned. When
+ * nothing overlaps, the first k documents are returned anyway so the agent still
+ * has context to ground (or honestly decline) against.
+ */
+export interface KnowledgeHit {
+    content: string;
+    source: string;
+    score: number;
+}
+/**
+ * A retriever: returns the most relevant documents for a query. Both the lexical
+ * {@link InMemoryKnowledge} and the embedding-backed `VectorKnowledge` satisfy
+ * this, so the agent accepts either.
+ */
+export interface Knowledge {
+    query(query: string, topK?: number): KnowledgeHit[];
+}
+export declare class InMemoryKnowledge {
+    private readonly docs;
+    /** Add a document to the knowledge base. */
+    ingest(content: string, source: string): void;
+    /** Return up to `topK` documents, ranked by token overlap with `query`. */
+    query(query: string, topK?: number): KnowledgeHit[];
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CACvD;AAWD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,4CAA4C;IAC5C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7C,2EAA2E;IAC3E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,YAAY,EAAE;CAsBjD"}

package/dist/knowledge.js

@@ -0,0 +1,43 @@
+/**
+ * In-memory knowledge base for the TypeScript smooth-operator core.
+ *
+ * A minimal lexical-overlap retriever — the Phase-0 sibling of the Rust engine's
+ * in-memory lexical store and the Python core's `InMemoryKnowledge`. Documents
+ * are scored by token overlap with the query; the top-k are returned. When
+ * nothing overlaps, the first k documents are returned anyway so the agent still
+ * has context to ground (or honestly decline) against.
+ */
+function tokenize(text) {
+    return text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+}
+export class InMemoryKnowledge {
+    docs = [];
+    /** Add a document to the knowledge base. */
+    ingest(content, source) {
+        this.docs.push({ content, source });
+    }
+    /** Return up to `topK` documents, ranked by token overlap with `query`. */
+    query(query, topK = 4) {
+        const qTokens = new Set(tokenize(query));
+        const scored = this.docs.map((doc) => {
+            const docTokens = new Set(tokenize(doc.content));
+            let overlap = 0;
+            for (const t of docTokens)
+                if (qTokens.has(t))
+                    overlap++;
+            return { overlap, doc };
+        });
+        scored.sort((a, b) => b.overlap - a.overlap);
+        const hits = scored
+            .slice(0, topK)
+            .filter((s) => s.overlap > 0)
+            .map((s) => ({ content: s.doc.content, source: s.doc.source, score: s.overlap }));
+        if (hits.length === 0) {
+            // No lexical overlap — still hand the model the first k docs so it can
+            // ground or honestly decline, rather than retrieving nothing.
+            return this.docs.slice(0, topK).map((doc) => ({ content: doc.content, source: doc.source, score: 0 }));
+        }
+        return hits;
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,SAAS,QAAQ,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,OAAO,iBAAiB;IACT,IAAI,GAAU,EAAE,CAAC;IAElC,4CAA4C;IAC5C,MAAM,CAAC,OAAe,EAAE,MAAc;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACjD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,OAAO,EAAE,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,MAAM;aACd,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEtF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,uEAAuE;YACvE,8DAA8D;YAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/llmProvider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * An `LlmProvider` seam over the LLM call so the agentic loop can be unit-tested
+ * deterministically, without a live model or network.
+ *
+ * The agent already takes an injected OpenAI-compatible chat client
+ * ({@link ChatClientLike}). This module *formalizes* that as the provider seam —
+ * `LlmProvider` is an alias of `ChatClientLike`, so the existing `SmoothAgent`
+ * constructor is unchanged and backward compatible (the real `openai` SDK still
+ * satisfies it).
+ *
+ * It also ships a reusable, exported {@link MockLlmProvider} that replaces the
+ * ad-hoc fake clients the tests rolled by hand. The mock:
+ *
+ * - is constructed with a script of responses — plain text, tool-call responses,
+ *   and errors;
+ * - returns them in FIFO order across calls;
+ * - records each request (the messages + tool specs it was given) so a test can
+ *   assert on what the agent sent.
+ *
+ * This mirrors the BEHAVIOR of the Rust reference's `MockLlmClient`
+ * (`rust/smooth-operator-core/src/llm_provider.rs`). The mock implements both the
+ * non-streaming `create` seam (used by {@link SmoothAgent.run}) and the streaming
+ * `createStream` seam (used by {@link SmoothAgent.runStream}): it replays the SAME
+ * FIFO script as chunked deltas — text split into a few pieces, tool-call
+ * `arguments` split across two chunks to exercise the accumulator, and a final
+ * chunk carrying usage. Structured-output lands when that feature lands here.
+ */
+import type { ChatChunk, ChatClientLike } from './agent.js';
+/** The LLM call surface the agent loop depends on. Identical to {@link ChatClientLike}. */
+export type LlmProvider = ChatClientLike;
+/** An OpenAI-shaped assistant message — the `choices[0].message` the agent reads. */
+export interface ScriptedMessage {
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }> | null;
+}
+/** Build a plain-text scripted response (no tool calls). */
+export declare function textResponse(content: string): ScriptedMessage;
+/** Build a scripted response that requests a single tool call. */
+export declare function toolCallResponse(id: string, name: string, args: string): ScriptedMessage;
+/** One request the mock received, captured for assertions. */
+export interface RecordedCall {
+    /** The full request body passed to `chat.completions.create`. */
+    body: Record<string, unknown>;
+    /** The messages passed on this call. */
+    messages: Array<Record<string, unknown>>;
+    /** The tool specs offered to the model, if any. */
+    tools?: Array<Record<string, unknown>>;
+}
+/** Optional token usage to attach to a scripted response (the model/gateway reports it). */
+export interface ScriptedUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+}
+/**
+ * A deterministic {@link LlmProvider} for tests. Script the responses it should
+ * return (FIFO), drive your code, then assert on {@link MockLlmProvider.calls}.
+ *
+ * Construct empty and build up fluently (`pushText` / `pushToolCall` / `pushError`),
+ * or pass an initial script of {@link ScriptedMessage}s.
+ *
+ * @example
+ * const mock = new MockLlmProvider();
+ * mock.pushText('hello there');
+ * const agent = new SmoothAgent(mock, {});
+ * const result = await agent.run('hi');
+ * expect(result.text).toBe('hello there');
+ * expect(mock.callCount).toBe(1);
+ */
+export declare class MockLlmProvider implements ChatClientLike {
+    private readonly script;
+    private readonly recorded;
+    constructor(script?: ScriptedMessage[]);
+    /** Queue a raw OpenAI-shaped assistant message (with optional usage) for the next call. */
+    pushResponse(message: ScriptedMessage, usage?: ScriptedUsage): this;
+    /** Queue a plain-text response (with optional usage) for the next call. */
+    pushText(content: string, usage?: ScriptedUsage): this;
+    /** Queue a single-tool-call response (with optional usage) for the next call. */
+    pushToolCall(id: string, name: string, args: string, usage?: ScriptedUsage): this;
+    /** Queue an error to be thrown on the next call. */
+    pushError(message: string): this;
+    /** Every request the mock has received so far, in order. */
+    get calls(): readonly RecordedCall[];
+    /** Number of requests received. */
+    get callCount(): number;
+    /** The most recent request, if any. */
+    get lastCall(): RecordedCall | undefined;
+    private record;
+    readonly chat: {
+        completions: {
+            create: (body: Record<string, unknown>) => Promise<{
+                choices: {
+                    message: ScriptedMessage;
+                }[];
+                usage: ScriptedUsage | null;
+            }>;
+            createStream: (body: Record<string, unknown>) => AsyncIterable<ChatChunk>;
+        };
+    };
+}
+//# sourceMappingURL=llmProvider.d.ts.map

package/dist/llmProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmProvider.d.ts","sourceRoot":"","sources":["../src/llmProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AAEzC,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAExF;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAKD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,MAAM,GAAE,eAAe,EAAO;IAM1C,2FAA2F;IAC3F,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAKnE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAItD,iFAAiF;IACjF,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAIjF,oDAAoD;IACpD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOhC,4DAA4D;IAC5D,IAAI,KAAK,IAAI,SAAS,YAAY,EAAE,CAEnC;IAED,mCAAmC;IACnC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,uCAAuC;IACvC,IAAI,QAAQ,IAAI,YAAY,GAAG,SAAS,CAEvC;IAID,OAAO,CAAC,MAAM;IAQd,QAAQ,CAAC,IAAI;;2BAEgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;iCAcvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,aAAa,CAAC,SAAS,CAAC;;MAiC7E;CACL"}