@harperfast/harper 5.0.25 → 5.1.0-beta.1

package/dist/resources/models/bootstrap.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapModels = bootstrapModels;
+/**
+ * YAML→registry boot bridge (#629 / #630 of #510).
+ *
+ * Reads the top-level `models` block from the root config and dispatches each
+ * `models.embedding.<name>` / `models.generative.<name>` entry to the matching
+ * per-backend register function. Backends self-contain in `components/<name>/`
+ * (matches the pattern in `components/mcp/index.ts` from PR #649).
+ *
+ * Boot site: `components/componentLoader.ts` calls this after `getConfigObj()`
+ * returns the root config and before per-component iteration, so that
+ * `scope.models.embed(...)` works from `handleApplication(scope)`.
+ *
+ * Env-var expansion: each entry's string leaves are run through
+ * `expandEnvVarsDeep` before dispatch — `apiKey: ${OPENAI_API_KEY}` in YAML
+ * becomes the resolved process.env value at the backend. Matches the
+ * convention from `@harperfast/oauth`'s config loader.
+ *
+ * Errors per entry are logged and skipped, not thrown — one misconfigured
+ * backend should not block Harper boot.
+ */
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const expandEnvVar_ts_1 = require("../../utility/expandEnvVar.js");
+const index_ts_1 = require("../../components/ollama/index.js");
+const index_ts_2 = require("../../components/openai/index.js");
+const index_ts_3 = require("../../components/anthropic/index.js");
+const index_ts_4 = require("../../components/bedrock/index.js");
+/**
+ * Field names treated as credentials. When present in config as a literal
+ * value (not a `${VAR}` placeholder), bootstrap warns the operator at boot
+ * — `harperdb-config.yaml` on disk in plaintext is a real anti-pattern.
+ * Extend this list as future backends add credential fields.
+ */
+const CREDENTIAL_FIELDS = new Set(['apiKey']);
+const FACTORIES = {
+    ollama: (args) => (0, index_ts_1.registerOllamaBackend)({ ...args, config: args.config }),
+    openai: (args) => (0, index_ts_2.registerOpenAIBackend)({ ...args, config: args.config }),
+    anthropic: (args) => (0, index_ts_3.registerAnthropicBackend)({ ...args, config: args.config }),
+    bedrock: (args) => (0, index_ts_4.registerBedrockBackend)({ ...args, config: args.config }),
+};
+/**
+ * Populate the model registry from `rootConfig.models`. No-op if the block
+ * is absent or empty. Idempotent within a process: each entry overwrites any
+ * prior registration under the same logical name (registry uses `.set()`).
+ */
+function bootstrapModels(rootConfig) {
+    const block = rootConfig?.models;
+    if (!block)
+        return;
+    registerKind('embedding', block.embedding);
+    registerKind('generative', block.generative);
+}
+function warnOnLiteralCredentials(kind, logicalName, entry) {
+    for (const field of CREDENTIAL_FIELDS) {
+        const value = entry[field];
+        if (typeof value !== 'string' || value.length === 0)
+            continue;
+        if ((0, expandEnvVar_ts_1.isUnresolvedEnvVarPlaceholder)(value))
+            continue; // operator is using ${VAR} indirection
+        harper_logger_ts_1.default.warn(`models.${kind}.${logicalName}: '${field}' is a literal value in harperdb-config.yaml; ` +
+            `prefer \${ENV_VAR} indirection for credentials to keep them off disk`);
+    }
+}
+function registerKind(kind, entries) {
+    if (!entries)
+        return;
+    for (const [logicalName, entry] of Object.entries(entries)) {
+        if (!entry || typeof entry !== 'object') {
+            // Schema validation (configValidator.ts) catches this before bootstrap
+            // runs, so reaching here means config was loaded by an unusual path
+            // (test, programmatic). Log at error so it's visible.
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName} is not an object; skipping`);
+            continue;
+        }
+        const factory = entry.backend ? FACTORIES[entry.backend] : undefined;
+        if (!factory) {
+            // Loud because the operator opted into `models:` specifically to enable
+            // a backend — silently registering nothing is a footgun. Schema-level
+            // typo guards (`.unknown(false)` on modelEntrySchema) catch field-name
+            // typos before this point; reaching here means `backend:` itself names
+            // a type Harper doesn't ship a factory for in this version. List the
+            // known backends so operators can spot value-name typos
+            // (`backend: 'openi'` instead of `'openai'`).
+            const known = Object.keys(FACTORIES).sort().join(', ');
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName}: unknown backend '${entry.backend ?? '(missing)'}'; skipping. Known backends: ${known}.`);
+            continue;
+        }
+        // Warn before expansion: literal credentials in `harperdb-config.yaml`
+        // land on disk, in backups, and (depending on deployment) in replicated
+        // config tables. The `${VAR}` indirection pattern from
+        // `@harperfast/oauth` is documented but not enforced.
+        warnOnLiteralCredentials(kind, logicalName, entry);
+        try {
+            // Resolve `${VAR}` placeholders on every string leaf before handing the
+            // entry to the backend factory. Backends receive concrete values and
+            // don't need to know about env-var syntax. Unresolved placeholders
+            // (env var unset) pass through unchanged — backend's required-field
+            // validation catches them with a meaningful error.
+            const resolved = (0, expandEnvVar_ts_1.expandEnvVarsDeep)(entry);
+            factory({ logicalName, kind, config: resolved });
+        }
+        catch (err) {
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName}: registration failed (${err?.message ?? err})`);
+        }
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/resources/models/bootstrap.js.map

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

package/dist/resources/models/embedHook.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@embed` directive write-time hook. `createDefaultEmbedder` builds the embedder
+ * a table registers for an `@embed` attribute; `buildEmbedBefore` produces the
+ * pre-commit callback that runs registered embedders and writes their vectors onto
+ * the record before it commits.
+ */
+export type EmbedConfig = {
+    source: string;
+    model: string;
+};
+export type EmbedAttribute = {
+    name: string;
+    embed: EmbedConfig;
+};
+export type Embedder = (record: any) => Promise<number[] | Float32Array | null | undefined>;
+type EmbedFn = (input: string | string[], opts: {
+    model?: string;
+    inputType?: 'document' | 'query';
+}) => Promise<Float32Array[]>;
+/** Test seam: override the embed function. Pass `undefined` to reset to `Models.embed`. */
+export declare function __setEmbedFnForTest(fn: EmbedFn | undefined): void;
+export declare function createDefaultEmbedder(embedConfig: EmbedConfig): Embedder;
+/**
+ * Build the pre-commit callback that runs embedders for every `@embed` attribute whose
+ * source field is present in this write. Returns `undefined` when there's nothing to do
+ * (no `@embed` attributes, a replication-receiver write, or no source field in the payload),
+ * so the call site can skip it.
+ *
+ * Source-field semantics: embed only when the source field is in the payload. A PATCH that
+ * omits it leaves the existing vector untouched; an explicit `source: null` clears the vector.
+ */
+export declare function buildEmbedBefore(record: any, context: any, options: any, embedAttributes: EmbedAttribute[] | undefined, userEmbedders: Record<string, Embedder>): (() => Promise<void>) | undefined;
+export {};

package/dist/resources/models/embedHook.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * `@embed` directive write-time hook. `createDefaultEmbedder` builds the embedder
+ * a table registers for an `@embed` attribute; `buildEmbedBefore` produces the
+ * pre-commit callback that runs registered embedders and writes their vectors onto
+ * the record before it commits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__setEmbedFnForTest = __setEmbedFnForTest;
+exports.createDefaultEmbedder = createDefaultEmbedder;
+exports.buildEmbedBefore = buildEmbedBefore;
+// Lazily resolved to avoid a require cycle on the unit-test load path; only needed on failure.
+function getLogger() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('#src/utility/logging/logger').logger ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+// Lazy-imported so this module can be unit-tested without loading the transaction
+// stack `Models.ts` pulls in. Overridable via `__setEmbedFnForTest`.
+let _embedFn;
+function resolveEmbedFn() {
+    if (_embedFn)
+        return _embedFn;
+    const { Models } = require('#src/resources/models/Models'); // eslint-disable-line @typescript-eslint/no-var-requires
+    const models = new Models();
+    _embedFn = (input, opts) => models.embed(input, opts);
+    return _embedFn;
+}
+/** Test seam: override the embed function. Pass `undefined` to reset to `Models.embed`. */
+function __setEmbedFnForTest(fn) {
+    _embedFn = fn;
+}
+function createDefaultEmbedder(embedConfig) {
+    const { source, model } = embedConfig;
+    return async (record) => {
+        const sourceValue = record?.[source];
+        if (sourceValue == null)
+            return null;
+        const vectors = await resolveEmbedFn()(String(sourceValue), {
+            model,
+            inputType: 'document',
+        });
+        const v = vectors?.[0];
+        if (v == null)
+            return undefined;
+        // Store as a plain array — typed arrays don't round-trip through the record encoder.
+        return v instanceof Float32Array ? Array.from(v) : Array.from(v);
+    };
+}
+/**
+ * Build the pre-commit callback that runs embedders for every `@embed` attribute whose
+ * source field is present in this write. Returns `undefined` when there's nothing to do
+ * (no `@embed` attributes, a replication-receiver write, or no source field in the payload),
+ * so the call site can skip it.
+ *
+ * Source-field semantics: embed only when the source field is in the payload. A PATCH that
+ * omits it leaves the existing vector untouched; an explicit `source: null` clears the vector.
+ */
+function buildEmbedBefore(record, context, options, embedAttributes, userEmbedders) {
+    if (!embedAttributes || embedAttributes.length === 0)
+        return undefined;
+    // Skip when the write already carries the vector: cluster-replication receiver
+    // (isNotification), REST x-replicate-from:none, or audit-log replay. Note that
+    // proactive source-subscribe pushes also set isNotification and so skip embedding.
+    if (options?.isNotification === true || context?.replicateFrom === false || context?.alreadyLogged === true) {
+        return undefined;
+    }
+    if (!record || typeof record !== 'object')
+        return undefined;
+    let anySourcePresent = false;
+    for (const attr of embedAttributes) {
+        const sourceKey = attr.embed?.source;
+        if (sourceKey && sourceKey in record) {
+            anySourcePresent = true;
+            break;
+        }
+    }
+    if (!anySourcePresent)
+        return undefined;
+    return async () => {
+        // Parallel: each embedder mutates a distinct attribute, so there's no ordering hazard.
+        await Promise.all(embedAttributes.map(async (attr) => {
+            const sourceKey = attr.embed?.source;
+            if (!sourceKey)
+                return;
+            if (!(sourceKey in record))
+                return;
+            const sourceValue = record[sourceKey];
+            if (sourceValue == null) {
+                record[attr.name] = null;
+                return;
+            }
+            // CRDT op payloads (`{__op__, value}`) aren't a meaningful embed source; skip.
+            if (sourceValue && typeof sourceValue === 'object' && sourceValue.__op__)
+                return;
+            const embedder = userEmbedders[attr.name];
+            if (!embedder)
+                return;
+            let vector;
+            try {
+                vector = await embedder(record);
+            }
+            catch (err) {
+                // Backend errors can carry URLs / key tails; log raw, rethrow sanitized.
+                getLogger().error?.(`Embedder for attribute "${attr.name}" failed:`, err);
+                throw new Error(`Failed to compute embedding for attribute "${attr.name}"`);
+            }
+            record[attr.name] = normalizeVector(vector);
+        }));
+    };
+}
+// Custom embedders may return any typed array; flatten to a plain array so it round-trips
+// through the record encoder. NaN is left for HNSW to reject at index time.
+function normalizeVector(vector) {
+    if (vector == null)
+        return null;
+    if (Array.isArray(vector))
+        return vector;
+    if (ArrayBuffer.isView(vector))
+        return Array.from(vector);
+    return vector;
+}
+//# sourceMappingURL=embedHook.js.map

package/dist/resources/models/embedHook.js.map

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

package/dist/resources/models/types.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Public type surface for the model-access API (`scope.models`).
+ *
+ * Phase 1 foundation of #510. Other phases (ollama, openai, gateway, @embed,
+ * anthropic, bedrock) consume these types; changes here cascade.
+ *
+ * Reference: planning artifact `tmp/harper-510-phase-1-detail.md` (canonical shapes).
+ */
+export interface Models {
+    embed(input: string | string[], opts?: EmbedOpts): Promise<Float32Array[]>;
+    generate(input: GenerateInput, opts?: GenerateOpts): Promise<GenerateResult>;
+    generateStream(input: GenerateInput, opts?: GenerateOpts): AsyncIterable<GenerateChunk>;
+}
+export interface ModelBackend {
+    readonly name: string;
+    capabilities(): ModelCapabilities;
+    embed?(input: string | string[], opts: BackendOpts<EmbedOpts>): Promise<ModelCallResult<Float32Array[]>>;
+    generate?(input: GenerateInput, opts: BackendOpts<GenerateOpts>): Promise<ModelCallResult<GenerateResult>>;
+    generateStream?(input: GenerateInput, opts: BackendOpts<GenerateOpts>): AsyncIterable<GenerateChunk>;
+}
+export interface ModelCapabilities {
+    embed: boolean;
+    generate: boolean;
+    stream: boolean;
+    tools: boolean;
+    adapters: boolean;
+}
+export type EmbedOpts = {
+    model?: string;
+    /** For models that distinguish document-vs-query embeddings (e.g. nomic-embed-text); ignored otherwise. */
+    inputType?: 'document' | 'query';
+    signal?: AbortSignal;
+};
+export type GenerateOpts = {
+    model?: string;
+    adapter?: string;
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: 'text' | 'json' | {
+        schema: object;
+    };
+    /**
+     * How to handle tool calls the model emits. `'return'` (default) hands tool-call
+     * requests back to the caller; `'auto'` resolves them in-process to completion.
+     * The tool definitions themselves live on `GenerateInput`'s object variant
+     * (alongside `messages` and `system`) — they're content, not strategy.
+     */
+    toolMode?: 'return' | 'auto';
+    /**
+     * `toolMode: 'auto'` only. Hard cap on backend → tool → backend iterations
+     * before the loop emits `BudgetExceededError({kind: 'iterations'})`. Default 10.
+     */
+    maxToolIterations?: number;
+    /**
+     * `toolMode: 'auto'` only. Cumulative prompt+completion token cap across all
+     * iterations. Trips `BudgetExceededError({kind: 'tokens'})` when exceeded.
+     *
+     * Best-effort: enforcement depends on the backend reporting `usage`. Against a
+     * backend that returns no usage the cap is unmeasurable — the loop warns once and
+     * continues (it does NOT silently pretend the cap is in force); `maxToolIterations`
+     * remains the hard bound. Not yet supported on `generateStream` (throws 501).
+     */
+    maxToolTokens?: number;
+    /**
+     * `toolMode: 'auto'` only. Cumulative cost cap across all iterations. The v1
+     * cost-per-call function returns 0 (no rate card yet) so this trips only when
+     * a test or follow-up wires a non-zero function — the seam is in place.
+     *
+     * Same best-effort caveat as `maxToolTokens`: cost is derived from backend usage,
+     * so a backend reporting no usage makes the cap unmeasurable (warn-once, continue).
+     * Not yet supported on `generateStream` (throws 501).
+     */
+    maxCostUsd?: number;
+    /**
+     * `toolMode: 'auto'` only. When a single backend round emits multiple tool calls,
+     * `'parallel'` (default) runs handlers concurrently via `Promise.all`; `'serial'`
+     * runs them in order. Each handler is its own dispatch — no shared transaction.
+     */
+    toolParallelism?: 'parallel' | 'serial';
+    /**
+     * `toolMode: 'auto'` only. Per-tool-result byte cap (JSON-stringified) before
+     * truncation. The model sees only the truncated form; the trace records the
+     * original size. Default 65_536.
+     */
+    toolResultMaxBytes?: number;
+    /**
+     * `toolMode: 'auto'` only. How to validate tool-call arguments against the
+     * tool's `parameters` JSON Schema. v1 implements `'none'` (default); `'strict'`
+     * and `'lenient'` are reserved on the type surface but throw `501` at the loop
+     * entry until a JSON Schema validator is wired (Harper today uses Joi for
+     * internal validation and passes JSON Schema through to backends; adopting
+     * Ajv is a separate decision).
+     */
+    toolArgValidation?: 'strict' | 'lenient' | 'none';
+    /**
+     * `toolMode: 'auto'` only. When a tool handler throws, `'recover'` (default)
+     * appends the error as a tool result so the model can react; `'abort'` returns
+     * the error to the caller with the full trace attached.
+     */
+    toolErrorMode?: 'recover' | 'abort';
+    /**
+     * `toolMode: 'auto'` only. When true, the resolved `GenerateResult.trace` is
+     * populated with per-iteration entries. On error paths the trace is always
+     * returned (via `BudgetExceededError.partialTrace`) regardless of this flag.
+     */
+    includeToolTrace?: boolean;
+    /**
+     * `toolMode: 'auto'` only. Caller-supplied dispatch table keyed by tool name.
+     * The model emits a tool call → loop looks up the handler here. v1 contract;
+     * the registry seam (#615) replaces this with a `scope.resources` lookup.
+     *
+     * Lookup is own-property + callable only (a model-emitted name matching an Object
+     * prototype member never resolves a built-in). Missing-handler behavior splits on
+     * whether the name was declared in `tools`: a DECLARED name with no handler is a
+     * caller config bug (hard `ClientError(400)`); an UNDECLARED name is treated as a
+     * model hallucination and routed through `toolErrorMode` (recover feeds an
+     * "unknown tool" error back to the model; abort stops the loop).
+     */
+    toolHandlers?: Record<string, ToolHandler>;
+    /**
+     * `toolMode: 'auto'` only. Optional hook called as turns flow through the loop
+     * (user → assistant → tool → assistant → ...). Structural shape — not coupled
+     * to #511's `ConversationResource` so callers can plug in their own store.
+     */
+    conversation?: ConversationAppender;
+    /** Accepted in Phase 1; activates with #511 (ConversationResource). */
+    conversationId?: string;
+    signal?: AbortSignal;
+};
+/**
+ * Generation input. Tools and system prompt live here (with `messages`) because
+ * they are model-facing content. Caller must use the object form to supply tools:
+ * `{ messages, tools, system }`.
+ */
+export type GenerateInput = string | Message[] | {
+    messages: Message[];
+    tools?: ToolDef[];
+    system?: string;
+};
+/** Options handed to a backend: caller-supplied opts plus runtime accounting context. */
+export type BackendOpts<TOpts> = TOpts & {
+    accounting: AccountingContext;
+};
+export interface AccountingContext {
+    /** Free-form tenant identifier (v1). Pending canonical model from #510 comment thread. */
+    tenantId?: string;
+    /** Resource path (e.g. matched route) of the calling Resource, if any. */
+    app?: string;
+}
+/**
+ * Backend call result.
+ *
+ * `pending` is reserved for future long-running operations (Bedrock batch, fabric LROs);
+ * no Phase 1 backend emits it. The public `Models` facade unwraps `completed` and
+ * matches #510's `Promise<Float32Array[]>` / `Promise<GenerateResult>` signatures,
+ * throwing if a backend returns `pending` until the LRO surface is added.
+ */
+export type ModelCallResult<T> = {
+    status: 'completed';
+    output: T;
+    usage?: TokenUsage;
+} | {
+    status: 'pending';
+    operationId: string;
+    resumeAfter?: number;
+};
+export interface TokenUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    embeddingTokens?: number;
+    gpuMs?: number;
+    latencyMs?: number;
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    /** When `role === 'assistant'`: tool calls the model requested. */
+    toolCalls?: ToolCall[];
+    /** When `role === 'tool'`: id of the tool call this message responds to. */
+    toolCallId?: string;
+}
+export interface ToolDef {
+    name: string;
+    description: string;
+    /** JSON Schema for the tool's input. */
+    parameters: object;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    /** Parsed tool input. Backends that deliver stringified JSON (OpenAI) normalize before yielding. */
+    arguments: object;
+}
+export interface GenerateResult {
+    content: string;
+    toolCalls?: ToolCall[];
+    /** Why generation stopped. Backend-agnostic; backends map their native reasons. */
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    /**
+     * Token / cost usage for this call. Pass-through from the backend's
+     * `ModelCallResult.usage` so callers (and the `toolMode: 'auto'` loop) can
+     * cap cumulative budgets without re-querying analytics.
+     *
+     * Backends MUST NOT set this field on the `output` they return — the framework
+     * (`Models.generate`) injects it from `ModelCallResult.usage`, which is the
+     * authoritative source. A backend that sets both gets the framework's value;
+     * easy to miss but unambiguous: usage lives at the call-result layer.
+     */
+    usage?: TokenUsage;
+    /**
+     * `toolMode: 'auto'` only, and only when `includeToolTrace: true` (or when an
+     * error path attaches `partialTrace` via `BudgetExceededError`). One entry per
+     * tool invocation, in the order it ran.
+     */
+    trace?: ToolTraceEntry[];
+}
+/**
+ * Per-tool-invocation record emitted by the `toolMode: 'auto'` loop. Entries land
+ * on `GenerateResult.trace` (success path, when `includeToolTrace`) or on
+ * `BudgetExceededError.partialTrace` (any error path). Always in invocation order.
+ */
+export interface ToolTraceEntry {
+    /** 1-based iteration index — which backend round this tool call belongs to. */
+    iteration: number;
+    toolCallId: string;
+    toolName: string;
+    arguments: object;
+    /** JSON-stringified result, possibly truncated. Absent on handler error. */
+    result?: string;
+    /** True when `result` was clipped to `toolResultMaxBytes`. */
+    truncated?: boolean;
+    /** Pre-truncation byte length of the JSON-stringified result. */
+    totalBytes?: number;
+    /** Wall-clock duration of the handler call. */
+    durationMs: number;
+    /** Set when the handler threw. The loop's `toolErrorMode` decides recovery. */
+    error?: {
+        name: string;
+        message: string;
+    };
+}
+/**
+ * Context handed to a `ToolHandler`. v1: caller-supplied dispatch table. The
+ * `signal` is the composed iteration-level signal (caller signal ∪ budget-trip
+ * cancellation), so a long-running handler stops promptly when the loop trips a cap.
+ */
+export interface ToolHandlerContext {
+    signal?: AbortSignal;
+    accounting: AccountingContext;
+}
+/**
+ * Caller-supplied tool implementation. Return value is JSON-serialized into a
+ * `tool`-role message and fed back to the model on the next iteration. Throws are
+ * caught by the loop and routed by `toolErrorMode` (`'recover'` | `'abort'`).
+ *
+ * The `args` type parameter lets typed apps assign concrete handler signatures
+ * (`const search: ToolHandler<{query: string}> = ...`) without contravariance
+ * complaints under `strictFunctionTypes`. Defaults to `any` so the unparameterized
+ * `ToolHandler` stays assignable from arbitrary handlers in untyped callers.
+ */
+export type ToolHandler<T = any> = (args: T, ctx: ToolHandlerContext) => unknown | Promise<unknown>;
+/**
+ * Optional hook the loop calls as conversation turns flow. Structural so the
+ * built-in `ConversationResource` (#511) AND ad-hoc stores can satisfy it.
+ *
+ * **Contract:**
+ * - The loop appends ONLY new turns it produces (assistant + tool turns from each
+ *   round). It does NOT echo the caller's input back — the caller owns turn 0.
+ * - `append` is `await`ed inline between loop steps, giving the appender ordering
+ *   + back-pressure. Slow appenders pause the loop.
+ * - Appenders SHOULD NOT throw. A throw propagates as the loop's terminal error
+ *   (bypassing `BudgetExceededError` / `ToolHandlerError` shapes) and discards any
+ *   in-progress trace. If your appender CAN fail recoverably, catch internally and
+ *   log; only surface unrecoverable persistence failures.
+ */
+export interface ConversationAppender {
+    append(turn: ConversationTurn): Promise<void>;
+}
+export type ConversationTurn = {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+} | {
+    role: 'tool';
+    toolCallId: string;
+    content: string;
+};
+export interface GenerateChunk {
+    /** Incremental text appended since the previous chunk. */
+    deltaContent?: string;
+    /**
+     * Tool-call deltas accumulating across chunks. A streaming backend may deliver
+     * the same tool-call id multiple times with partial fields as it builds up.
+     */
+    deltaToolCalls?: Partial<ToolCall>[];
+    /** Set on the final chunk. */
+    finishReason?: GenerateResult['finishReason'];
+}

package/dist/resources/models/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Public type surface for the model-access API (`scope.models`).
+ *
+ * Phase 1 foundation of #510. Other phases (ollama, openai, gateway, @embed,
+ * anthropic, bedrock) consume these types; changes here cascade.
+ *
+ * Reference: planning artifact `tmp/harper-510-phase-1-detail.md` (canonical shapes).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/resources/models/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../resources/models/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/resources/replayLogs.js

@@ -71,7 +71,13 @@ function replayLogs(rootStore, tables) {
                 const Table = tableById.get(tableId);
                 if (!Table)
                     continue;
-                const context = { nodeId, alreadyLogged: true, version, expiresAt, user: { name: username } };
+                const context = {
+                    nodeId,
+                    alreadyLogged: true,
+                    version,
+                    expiresAt,
+                    user: { username },
+                };
                 const { primaryStore } = Table;
                 const target = new RequestTarget_ts_1.RequestTarget();
                 target.id = null;

package/dist/resources/replayLogs.js.map

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

package/dist/resources/roles.d.ts

@@ -2,10 +2,4 @@
  * This is the component for handling role declarations in the Harper system. This will read roles.yaml for role
  * definitions and ensure that they are created in the system database.
  */
-export declare function start({ ensureTable }: {
-    ensureTable: any;
-}): {
-    handleFile: (rolesContent: any) => Promise<void>;
-    setupFile: (rolesContent: any) => Promise<void>;
-};
-export declare const startOnMainThread: typeof start;
+export declare function handleApplication(scope: import('../components/Scope.ts').Scope): void;