@aid-framework/runtime 0.0.0 → 0.1.48

package/dist/gateway.js

@@ -0,0 +1,250 @@
+/**
+ * The model gateway: alias resolution, capability negotiation, cost accounting.
+ *
+ * Three responsibilities, in this order:
+ *
+ * 1. **Pinning.** An alias resolves to an exact provider model id. Unknown aliases are
+ *    an error; there is no fall-through to a provider default, because a provider
+ *    default is precisely the floating version a stored eval baseline cannot survive.
+ * 2. **Ordered fallback.** A caller may name fallback aliases. They are tried in the
+ *    order given, and the aliases actually attempted are reported on the result.
+ *    Escalation routing -- "use the strong model if the cheap one is unsure" -- is
+ *    *not* implemented: "unsure" needs an agent loop to define.
+ * 3. **Budgets and tracing.** Every charged call opens a GenAI span and updates the
+ *    ledger.
+ */
+import { CostLedger, estimatePromptCostUsd } from './cost.js';
+import { BudgetExceededError, CapabilityMismatchError, ConfigurationError, FeatureDeferredError, ProviderError, UnknownModelAliasError, } from './errors.js';
+import { ATTRIBUTES, recordCost, recordUsage, withLlmSpan, } from './tracing.js';
+import { GenerationResult, PinnedModel, TokenUsage, } from './types.js';
+/** Resolves aliases to pinned models and executes calls within a budget. */
+export class ModelGateway {
+    _providers;
+    _aliases;
+    _ledger;
+    _budget;
+    _hooks;
+    _tracerName;
+    _limiter;
+    constructor(options) {
+        const providers = new Map(Object.entries(options.providers));
+        const aliases = new Map(Object.entries(options.aliases));
+        if (providers.size === 0)
+            throw new ConfigurationError('the gateway needs at least one provider');
+        if (aliases.size === 0) {
+            throw new ConfigurationError('the gateway needs at least one pinned alias');
+        }
+        const resolved = new Map();
+        for (const [alias, value] of aliases) {
+            const spec = value instanceof PinnedModel ? value.model : value;
+            if (!providers.has(spec.provider)) {
+                const known = [...providers.keys()].sort();
+                throw new ConfigurationError(`alias ${JSON.stringify(alias)} names provider ${JSON.stringify(spec.provider)}, which is not among ${JSON.stringify(known)}`);
+            }
+            resolved.set(alias, spec);
+        }
+        this._providers = providers;
+        this._aliases = resolved;
+        this._ledger = options.ledger ?? new CostLedger();
+        this._budget = options.budget;
+        this._hooks = options.onCall ?? [];
+        this._tracerName = options.tracerName ?? 'aid_runtime';
+        this._limiter = options.limiter;
+    }
+    /** The pinned aliases, sorted. */
+    get aliases() {
+        return [...this._aliases.keys()].sort();
+    }
+    get ledger() {
+        return this._ledger;
+    }
+    get budget() {
+        return this._budget;
+    }
+    /** Resolve an alias to its pinned model, or fail loudly. */
+    resolve(alias) {
+        const spec = this._aliases.get(alias);
+        if (spec === undefined)
+            throw new UnknownModelAliasError(alias, this.aliases);
+        return new PinnedModel({ alias, model: spec });
+    }
+    /** The adapter that serves `alias`. Raises for an unknown alias. */
+    providerFor(alias) {
+        const provider = this._providers.get(this.resolve(alias).model.provider);
+        if (provider === undefined)
+            throw new UnknownModelAliasError(alias, this.aliases);
+        return provider;
+    }
+    /**
+     * Assert a pinned model *and* its adapter advertise every capability.
+     *
+     * Both sides are checked: a model that supports tool calling behind an adapter that
+     * does not serialise tool definitions cannot tool-call.
+     */
+    require(alias, capabilities) {
+        const pinned = this.resolve(alias);
+        const required = new Set(capabilities);
+        const adapter = this._providers.get(pinned.model.provider);
+        const missing = new Set();
+        for (const capability of required) {
+            if (!pinned.model.capabilities.has(capability))
+                missing.add(capability);
+            if (adapter === undefined || !adapter.capabilities.has(capability))
+                missing.add(capability);
+        }
+        if (missing.size > 0)
+            throw new CapabilityMismatchError(alias, missing);
+        return pinned;
+    }
+    /**
+     * Run one call, falling back through `fallbacks` in order.
+     *
+     * A fallback is only tried for a failure another model could plausibly survive: a
+     * provider error or a missing capability. A {@link BudgetExceededError} propagates
+     * immediately -- retrying a different model cannot make an exhausted budget
+     * affordable.
+     */
+    async generate(alias, request, options = {}) {
+        const chain = [alias, ...(options.fallbacks ?? [])];
+        const errors = [];
+        const budget = options.budget ?? this._budget;
+        for (const [index, candidate] of chain.entries()) {
+            const pinned = this.resolve(candidate);
+            try {
+                return await this.attempt(pinned, request, budget, chain.slice(0, index + 1));
+            }
+            catch (error) {
+                if (!(error instanceof ProviderError) && !(error instanceof CapabilityMismatchError)) {
+                    throw error;
+                }
+                errors.push(`${candidate}: ${error.message}`);
+                if (index === chain.length - 1) {
+                    throw new ProviderError(`every candidate failed (${chain.length} tried): ${errors.join('; ')}`);
+                }
+            }
+        }
+        throw new ProviderError(`no candidate produced a response: ${errors.join('; ')}`);
+    }
+    /** Declared but not implemented; see the module docstring. */
+    async stream(_alias, _request) {
+        throw new FeatureDeferredError('streaming is a declared capability, not an implemented one; ' +
+            'Phase 0 serves request/response only');
+    }
+    async close() {
+        for (const provider of this._providers.values()) {
+            await provider.close();
+        }
+    }
+    /**
+     * What this request's prompt would cost on top of what is already spent.
+     *
+     * Public because a routing decision needs the same number the preflight enforces: an
+     * agent stepping down a price ladder asks whether the *cheaper* alias fits before
+     * switching, and a second estimator would let the two disagree about the same ceiling.
+     */
+    projectedCostUsd(alias, request) {
+        const pinned = this.resolve(alias);
+        let projected = this._ledger.costUsd;
+        for (const message of request.messages) {
+            projected += estimatePromptCostUsd(pinned.model, message.content);
+        }
+        return projected;
+    }
+    /**
+     * Whether this request still fits the budget. A question, never a charge.
+     *
+     * An unset ceiling always fits -- there is nothing to exceed. An *already* exceeded
+     * budget does not fit whatever the prompt, which is what makes a degraded agent stop
+     * rather than step down for every remaining step.
+     */
+    fits(alias, request, budget) {
+        if (budget === undefined || budget.maxUsd === undefined)
+            return true;
+        if (this._ledger.costUsd > budget.maxUsd)
+            return false;
+        return this.projectedCostUsd(alias, request) <= budget.maxUsd;
+    }
+    async attempt(pinned, request, budget, attempted) {
+        if (budget !== undefined) {
+            this._ledger.check(budget);
+            this.preflight(pinned, request, budget);
+        }
+        const spec = pinned.model;
+        const provider = this._providers.get(spec.provider);
+        if (provider === undefined) {
+            throw new UnknownModelAliasError(pinned.alias, this.aliases);
+        }
+        const spanOptions = {
+            model: spec.name,
+            system: spec.provider,
+            alias: pinned.alias,
+            requestTemperature: request.temperature,
+            requestMaxTokens: request.maxOutputTokens,
+            tracerName: this._tracerName,
+        };
+        const { response, cost } = await this.limit(() => withLlmSpan(spanOptions, async (handle) => {
+            const answered = await provider.complete(request, spec);
+            const priced = spec.cost.costUsd(answered.usage);
+            recordUsage(handle.span, answered.usage.inputTokens, answered.usage.outputTokens);
+            recordCost(handle.span, priced);
+            handle.span.setAttribute(ATTRIBUTES.responseModel, answered.model);
+            handle.span.setAttribute(ATTRIBUTES.responseFinishReasons, [answered.finishReason]);
+            if (attempted.length > 1) {
+                handle.span.setAttribute(ATTRIBUTES.attempts, [...attempted]);
+            }
+            return { response: answered, cost: priced };
+        }));
+        const entry = {
+            alias: pinned.alias,
+            model: response.model,
+            provider: response.provider,
+            usage: response.usage,
+            costUsd: cost,
+        };
+        this._ledger.charge(budget, entry);
+        for (const hook of this._hooks)
+            hook(entry);
+        return new GenerationResult({
+            response,
+            alias: pinned.alias,
+            costUsd: cost,
+            attempts: [...attempted],
+        });
+    }
+    /**
+     * Acquire the shared concurrency slot around one provider call.
+     *
+     * The slot wraps the call, not the surrounding bookkeeping, so a cache hit or a
+     * refused call never consumes one, and the slot is released on completion and on
+     * failure alike.
+     */
+    async limit(body) {
+        if (this._limiter === undefined)
+            return body();
+        return this._limiter.run(body);
+    }
+    /**
+     * Refuse a call whose *prompt* alone already breaches the budget.
+     *
+     * Only the prompt is priced, and deliberately over-estimated, because the response
+     * is unknowable before the call. This catches gross overruns early; the post-call
+     * charge is what enforces the ceiling exactly.
+     */
+    preflight(pinned, request, budget) {
+        if (budget.maxUsd === undefined)
+            return;
+        const projected = this.projectedCostUsd(pinned.alias, request);
+        if (projected > budget.maxUsd) {
+            throw new BudgetExceededError(budget.scope, budget.maxUsd, projected);
+        }
+    }
+}
+/** Token estimate for a set of strings, at the usual four characters per token. */
+export function estimateUsage(texts) {
+    const list = typeof texts === 'string' ? [texts] : texts;
+    let input = 0;
+    for (const text of list)
+        input += (text.length + 3) >> 2;
+    return new TokenUsage({ inputTokens: input, outputTokens: 0 });
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * AID runtime for TypeScript: the execution half of a generated application.
+ *
+ * The AID framework generates an application from an IR that declares *what* the app
+ * does. This package is what the generated code calls at runtime: pin a model, run a
+ * prompt, call a tool, trace it, stay inside a budget, and prove that quality did not
+ * regress.
+ *
+ * Design boundaries worth stating up front, because they are deliberate:
+ *
+ * - **Control flow is plain async TypeScript.** There is no graph or orchestration
+ *   engine here. A generated app is ordinary code that is easy to read and to test.
+ * - **zod is used only for structured output.** No other responsibility is delegated
+ *   to it.
+ * - **Streaming is declared, not implemented.** `Capability` includes it so a spec
+ *   can require it and a gate can check it; calling `ModelGateway.stream` raises
+ *   {@link FeatureDeferredError}.
+ * - **One HTTP provider adapter and one fake.** Breadth of vendor coverage is a
+ *   Phase 2 concern; a narrow, correct seam is worth more now than a wide shallow one.
+ *
+ * This file mirrors the Python package's `__all__`. The exports it adds beyond that
+ * list are types a TypeScript consumer cannot avoid naming -- option bags, span
+ * handles, tool handler and parameter types -- because there is no structural way to
+ * pass them otherwise.
+ */
+export * from './agents/index.js';
+export { ConcurrencyLimiter, holdsSlot } from './concurrency.js';
+export type { CompositeStep } from './control.js';
+export { branch, DEPTH_KEY, INDEX_KEY, ITEM_KEY, LIMITER_KEY, MAX_STEP_DEPTH, mapStep, PRINCIPAL_KEY, parallel, REDUCED_KEY, RESERVED_KEYS, reduceStep, } from './control.js';
+export { Budget, CostLedger, estimateCostUsd, estimatePromptCostUsd, LedgerEntry, SpendSummary, } from './cost.js';
+export { AgentBudgetDegradedError, AgentHandoffUnsupportedError, AgentTransferCycleError, AidRuntimeError, BudgetExceededError, CapabilityMismatchError, ConfigurationError, DeepAgentsEngineError, DeepAgentsMaxStepsError, DeepAgentsUnavailableError, DeepAgentsVersionMismatchError, EvalError, FeatureDeferredError, GateConfigurationError, GuardrailBlockedError, PipelineError, PolicyEvaluationError, PromptNotFoundError, PromptRenderError, ProviderError, ProviderResponseError, StructuredOutputError, ToolArgumentError, ToolExecutionError, ToolNotFoundError, ToolPermissionError, UnknownModelAliasError, } from './errors.js';
+export type { EvalCaseInit } from './evals/dataset.js';
+export { Dataset, EvalCase } from './evals/dataset.js';
+export type { BaselineGateOptions } from './evals/gate.js';
+export { BaselineGate, EvalBaseline, EvalRun, GateResult, gateFromConfig, MetricBaseline, MetricGateResult, MetricRun, regressionZ, Threshold, zCritical, } from './evals/gate.js';
+export type { JudgeCall, Metric } from './evals/metrics.js';
+export { AssertMetric, defaultMetrics, ExactMatch, JsonSchemaValid, JudgeVerdict, LlmJudge, MetricResult, metricNames, NormalizedContains, normalize, } from './evals/metrics.js';
+export type { GatewayRunnerOptions, Runner } from './evals/runner.js';
+export { CaseOutcome, DatasetRun, evaluateOnce, GatewayRunner, gatewayJudge, runEvaluation, } from './evals/runner.js';
+export type { AliasEntry, CallHook, ModelGatewayOptions } from './gateway.js';
+export { estimateUsage, ModelGateway } from './gateway.js';
+export type { NamedStep, Step, StepResult } from './pipeline.js';
+export { Pipeline, PipelineContext, STEPS_KEY, StopPipeline } from './pipeline.js';
+export type { PolicyNode } from './policy.js';
+export { evaluatePolicy, POLICY_BUILTIN_ARITY, POLICY_BUILTINS, Principal, policySource, } from './policy.js';
+export { Example, PromptRegistry, PromptTemplate, RenderedPrompt } from './prompts.js';
+export type { Provider } from './providers/base.js';
+export { supports } from './providers/base.js';
+export type { FakeProviderOptions, Responder } from './providers/fake.js';
+export { FakeProvider, ScriptedTurn } from './providers/fake.js';
+export type { FetchLike, OpenAICompatibleOptions } from './providers/http.js';
+export { DEFAULT_BASE_URL, OpenAICompatibleProvider } from './providers/http.js';
+export type { Chunker, MarkerGroups } from './retrieval/chunking.js';
+export { CodeChunker, chunkDocument, chunkerFor, FixedChunker, RecursiveChunker, } from './retrieval/chunking.js';
+export { assembleContext, Citation, cite, RetrievalResult, RetrievedItem, } from './retrieval/citations.js';
+export type { Connector } from './retrieval/connectors.js';
+export { FileConnector, openConnector, SourceDocument } from './retrieval/connectors.js';
+export type { Embedder } from './retrieval/embedding.js';
+export { EmbeddingBatch, embedderFor, estimateTokens, FakeDeterministicEmbedder, OpenAICompatibleEmbedder, } from './retrieval/embedding.js';
+export { RetrievalGate } from './retrieval/gate.js';
+export { bm25Scores, fuse, lexicalRanking, RankedId, rrfScore, tokenize, } from './retrieval/hybrid.js';
+export type { RetrievalMetric } from './retrieval/metrics.js';
+export { CitationGrounding, MeanReciprocalRank, RecallAtK, RetrievalCase, retrievalMetrics, } from './retrieval/metrics.js';
+export { PgVectorStore, parseVector, resolveUri, vectorLiteral } from './retrieval/pgvector.js';
+export type { Reranker } from './retrieval/rerank.js';
+export { LexicalReranker, lexicalScore, rerankerFor } from './retrieval/rerank.js';
+export type { RetrieverOptions } from './retrieval/retriever.js';
+export { DEFAULT_CANDIDATE_FACTOR, IngestReport, Retriever } from './retrieval/retriever.js';
+export type { VectorStore } from './retrieval/stores.js';
+export { createStore, InMemoryVectorStore, SearchHit, StoreRecord, similarity, } from './retrieval/stores.js';
+export type { ChunkingStrategy, DistanceMetric, RefreshMode, SourceKind, StoreKind, } from './retrieval/types.js';
+export { bindingFromSpec, Chunk, ChunkingSpec, chunkIdFor, DISTANCE_METRICS, EmbeddingCostProfile, EmbeddingSpec, IndexSpec, PinnedEmbedding, pinnedEmbedding, RefreshSpec, RerankSpec, RetrievalMetricSpec, RetrieverBinding, RetrieverSpec, ScoredChunk, SourceSpec, VectorStoreSpec, } from './retrieval/types.js';
+export type { RetrieverSeam } from './steps.js';
+export { EMITTED_KEY, emitStep, generateStep, resolveSource, retrieveStep, toolStep, } from './steps.js';
+export type { AgentModel, StructuredOutput } from './structured.js';
+export { buildAgent, formatProblems, parseStructured, repairPrompt, runStructured, StructuredAgent, structuredOutput, } from './structured.js';
+export type { ToolHandler, ToolParameters } from './tools.js';
+export { Tool, ToolExecutor, validateArguments } from './tools.js';
+export type { LlmSpanHandle, LlmSpanOptions } from './tracing.js';
+export { ATTRIBUTES, aidAttributes, GEN_AI_OPERATION_CHAT, getTracer, llmSpan, recordCost, recordException, recordUsage, } from './tracing.js';
+export type { Capability, FinishReason, Role } from './types.js';
+export { CompletionRequest, CompletionResponse, CostProfile, GenerationResult, Message, ModelSpec, PinnedModel, TokenUsage, ToolCall, ToolDefinition, ToolResult, } from './types.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":"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"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * AID runtime for TypeScript: the execution half of a generated application.
+ *
+ * The AID framework generates an application from an IR that declares *what* the app
+ * does. This package is what the generated code calls at runtime: pin a model, run a
+ * prompt, call a tool, trace it, stay inside a budget, and prove that quality did not
+ * regress.
+ *
+ * Design boundaries worth stating up front, because they are deliberate:
+ *
+ * - **Control flow is plain async TypeScript.** There is no graph or orchestration
+ *   engine here. A generated app is ordinary code that is easy to read and to test.
+ * - **zod is used only for structured output.** No other responsibility is delegated
+ *   to it.
+ * - **Streaming is declared, not implemented.** `Capability` includes it so a spec
+ *   can require it and a gate can check it; calling `ModelGateway.stream` raises
+ *   {@link FeatureDeferredError}.
+ * - **One HTTP provider adapter and one fake.** Breadth of vendor coverage is a
+ *   Phase 2 concern; a narrow, correct seam is worth more now than a wide shallow one.
+ *
+ * This file mirrors the Python package's `__all__`. The exports it adds beyond that
+ * list are types a TypeScript consumer cannot avoid naming -- option bags, span
+ * handles, tool handler and parameter types -- because there is no structural way to
+ * pass them otherwise.
+ */
+export * from './agents/index.js';
+export { ConcurrencyLimiter, holdsSlot } from './concurrency.js';
+export { branch, DEPTH_KEY, INDEX_KEY, ITEM_KEY, LIMITER_KEY, MAX_STEP_DEPTH, mapStep, PRINCIPAL_KEY, parallel, REDUCED_KEY, RESERVED_KEYS, reduceStep, } from './control.js';
+export { Budget, CostLedger, estimateCostUsd, estimatePromptCostUsd, LedgerEntry, SpendSummary, } from './cost.js';
+export { AgentBudgetDegradedError, AgentHandoffUnsupportedError, AgentTransferCycleError, AidRuntimeError, BudgetExceededError, CapabilityMismatchError, ConfigurationError, DeepAgentsEngineError, DeepAgentsMaxStepsError, DeepAgentsUnavailableError, DeepAgentsVersionMismatchError, EvalError, FeatureDeferredError, GateConfigurationError, GuardrailBlockedError, PipelineError, PolicyEvaluationError, PromptNotFoundError, PromptRenderError, ProviderError, ProviderResponseError, StructuredOutputError, ToolArgumentError, ToolExecutionError, ToolNotFoundError, ToolPermissionError, UnknownModelAliasError, } from './errors.js';
+export { Dataset, EvalCase } from './evals/dataset.js';
+export { BaselineGate, EvalBaseline, EvalRun, GateResult, gateFromConfig, MetricBaseline, MetricGateResult, MetricRun, regressionZ, Threshold, zCritical, } from './evals/gate.js';
+export { AssertMetric, defaultMetrics, ExactMatch, JsonSchemaValid, JudgeVerdict, LlmJudge, MetricResult, metricNames, NormalizedContains, normalize, } from './evals/metrics.js';
+export { CaseOutcome, DatasetRun, evaluateOnce, GatewayRunner, gatewayJudge, runEvaluation, } from './evals/runner.js';
+export { estimateUsage, ModelGateway } from './gateway.js';
+export { Pipeline, PipelineContext, STEPS_KEY, StopPipeline } from './pipeline.js';
+export { evaluatePolicy, POLICY_BUILTIN_ARITY, POLICY_BUILTINS, Principal, policySource, } from './policy.js';
+export { Example, PromptRegistry, PromptTemplate, RenderedPrompt } from './prompts.js';
+export { supports } from './providers/base.js';
+export { FakeProvider, ScriptedTurn } from './providers/fake.js';
+export { DEFAULT_BASE_URL, OpenAICompatibleProvider } from './providers/http.js';
+export { CodeChunker, chunkDocument, chunkerFor, FixedChunker, RecursiveChunker, } from './retrieval/chunking.js';
+export { assembleContext, Citation, cite, RetrievalResult, RetrievedItem, } from './retrieval/citations.js';
+export { FileConnector, openConnector, SourceDocument } from './retrieval/connectors.js';
+export { EmbeddingBatch, embedderFor, estimateTokens, FakeDeterministicEmbedder, OpenAICompatibleEmbedder, } from './retrieval/embedding.js';
+export { RetrievalGate } from './retrieval/gate.js';
+export { bm25Scores, fuse, lexicalRanking, RankedId, rrfScore, tokenize, } from './retrieval/hybrid.js';
+export { CitationGrounding, MeanReciprocalRank, RecallAtK, RetrievalCase, retrievalMetrics, } from './retrieval/metrics.js';
+export { PgVectorStore, parseVector, resolveUri, vectorLiteral } from './retrieval/pgvector.js';
+export { LexicalReranker, lexicalScore, rerankerFor } from './retrieval/rerank.js';
+export { DEFAULT_CANDIDATE_FACTOR, IngestReport, Retriever } from './retrieval/retriever.js';
+export { createStore, InMemoryVectorStore, SearchHit, StoreRecord, similarity, } from './retrieval/stores.js';
+export { bindingFromSpec, Chunk, ChunkingSpec, chunkIdFor, DISTANCE_METRICS, EmbeddingCostProfile, EmbeddingSpec, IndexSpec, PinnedEmbedding, pinnedEmbedding, RefreshSpec, RerankSpec, RetrievalMetricSpec, RetrieverBinding, RetrieverSpec, ScoredChunk, SourceSpec, VectorStoreSpec, } from './retrieval/types.js';
+export { EMITTED_KEY, emitStep, generateStep, resolveSource, retrieveStep, toolStep, } from './steps.js';
+export { buildAgent, formatProblems, parseStructured, repairPrompt, runStructured, StructuredAgent, structuredOutput, } from './structured.js';
+export { Tool, ToolExecutor, validateArguments } from './tools.js';
+export { ATTRIBUTES, aidAttributes, GEN_AI_OPERATION_CHAT, getTracer, llmSpan, recordCost, recordException, recordUsage, } from './tracing.js';
+export { CompletionRequest, CompletionResponse, CostProfile, GenerationResult, Message, ModelSpec, PinnedModel, TokenUsage, ToolCall, ToolDefinition, ToolResult, } from './types.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":"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"}

package/dist/internal/json.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Canonical JSON and hashing helpers.
+ *
+ * Every hash in this runtime is taken over a canonical serialisation rather than
+ * over `JSON.stringify` of an object in insertion order, because an object built in
+ * a different order must still produce the same chunk id, the same fingerprint and
+ * the same fake-provider answer.
+ */
+/**
+ * A Python-style `repr()` for a string.
+ *
+ * Error messages name the offending value, and quoting it the way the reference
+ * runtime does keeps the two runtimes' diagnostics greppable as one corpus.
+ */
+export declare function repr(value: string): string;
+/** Round to a fixed number of decimal places. */
+export declare function roundTo(value: number, digits: number): number;
+/** Lowercase hex SHA-256 of a UTF-8 string. */
+export declare function sha256Hex(text: string): string;
+/** Lowercase hex SHA-256 of UTF-8 parts, each followed by a NUL separator. */
+export declare function sha256Parts(parts: readonly string[]): string;
+interface SortOptions {
+    /** Drop `null` members, mirroring `model_dump(exclude_none=True)`. */
+    readonly excludeNull?: boolean;
+}
+/**
+ * JSON with object keys sorted at every depth.
+ *
+ * Byte-for-byte stable across construction order, which is what makes it usable as
+ * hash input.
+ */
+export declare function canonicalJson(value: unknown, options?: SortOptions): string;
+/**
+ * `json.dumps(value, sort_keys=True, default=str)`.
+ *
+ * Used where a tool hands back an arbitrary value: it must serialise rather than
+ * throw, because a tool result is data flowing back to a model, not a place to
+ * raise.
+ */
+export declare function dumpsSorted(value: unknown): string;
+/** The first `count` hex characters of a SHA-256 digest. */
+export declare function digestPrefix(text: string, count?: number): string;
+export {};
+//# sourceMappingURL=json.d.ts.map

package/dist/internal/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/internal/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO5D;AAED,UAAU,WAAW;IACnB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAuBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAE5D"}

package/dist/internal/json.js

@@ -0,0 +1,90 @@
+/**
+ * Canonical JSON and hashing helpers.
+ *
+ * Every hash in this runtime is taken over a canonical serialisation rather than
+ * over `JSON.stringify` of an object in insertion order, because an object built in
+ * a different order must still produce the same chunk id, the same fingerprint and
+ * the same fake-provider answer.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * A Python-style `repr()` for a string.
+ *
+ * Error messages name the offending value, and quoting it the way the reference
+ * runtime does keeps the two runtimes' diagnostics greppable as one corpus.
+ */
+export function repr(value) {
+    if (value.includes("'") && !value.includes('"')) {
+        return `"${value.replaceAll('\\', '\\\\').replaceAll('"', '\\"')}"`;
+    }
+    return `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+}
+/** Round to a fixed number of decimal places. */
+export function roundTo(value, digits) {
+    const factor = 10 ** digits;
+    return Math.round(value * factor) / factor;
+}
+/** Lowercase hex SHA-256 of a UTF-8 string. */
+export function sha256Hex(text) {
+    return createHash('sha256').update(text, 'utf8').digest('hex');
+}
+/** Lowercase hex SHA-256 of UTF-8 parts, each followed by a NUL separator. */
+export function sha256Parts(parts) {
+    const hash = createHash('sha256');
+    for (const part of parts) {
+        hash.update(part, 'utf8');
+        hash.update(Buffer.from([0]));
+    }
+    return hash.digest('hex');
+}
+function sortValue(value, options) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => sortValue(entry, options));
+    }
+    if (value instanceof Set) {
+        return [...value].map((entry) => sortValue(entry, options));
+    }
+    if (typeof value === 'object' && value !== null) {
+        const source = value;
+        const sorted = {};
+        for (const key of Object.keys(source).sort()) {
+            const entry = source[key];
+            if (entry === undefined)
+                continue;
+            if (options.excludeNull === true && entry === null)
+                continue;
+            sorted[key] = sortValue(entry, options);
+        }
+        return sorted;
+    }
+    return value;
+}
+/**
+ * JSON with object keys sorted at every depth.
+ *
+ * Byte-for-byte stable across construction order, which is what makes it usable as
+ * hash input.
+ */
+export function canonicalJson(value, options = {}) {
+    return JSON.stringify(sortValue(value, options));
+}
+/**
+ * `json.dumps(value, sort_keys=True, default=str)`.
+ *
+ * Used where a tool hands back an arbitrary value: it must serialise rather than
+ * throw, because a tool result is data flowing back to a model, not a place to
+ * raise.
+ */
+export function dumpsSorted(value) {
+    try {
+        return canonicalJson(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** The first `count` hex characters of a SHA-256 digest. */
+export function digestPrefix(text, count = 8) {
+    return sha256Hex(text).slice(0, count);
+}
+//# sourceMappingURL=json.js.map

package/dist/internal/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/internal/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;AACtE,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,MAAc;IACnD,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC7C,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAOD,SAAS,SAAS,CAAC,KAAc,EAAE,OAAoB;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7D,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAO,GAAgB,EAAE;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;IAClD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/internal/text.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Small string helpers that are deliberately not written with regular expressions.
+ *
+ * Every function here takes arbitrary-length input, and a regex with a quantifier
+ * costs steps proportional to the run it consumes: `/\/+$/` on a string of a hundred
+ * thousand slashes is a polynomial number of steps for a one-line trim. Scans are
+ * linear whatever arrives, so these call sites cannot be turned into a denial of
+ * service by the value they are handed.
+ */
+/**
+ * Drop every trailing `/`.
+ *
+ * Mirrors `/\/+$/` exactly, including the degenerate `'https://'` -> `'https:'`:
+ * stripping is unconditional, so a URL that is nothing but a scheme loses its `//`.
+ */
+export declare function stripTrailingSlashes(value: string): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/internal/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/internal/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D"}

package/dist/internal/text.js

@@ -0,0 +1,22 @@
+/**
+ * Small string helpers that are deliberately not written with regular expressions.
+ *
+ * Every function here takes arbitrary-length input, and a regex with a quantifier
+ * costs steps proportional to the run it consumes: `/\/+$/` on a string of a hundred
+ * thousand slashes is a polynomial number of steps for a one-line trim. Scans are
+ * linear whatever arrives, so these call sites cannot be turned into a denial of
+ * service by the value they are handed.
+ */
+/**
+ * Drop every trailing `/`.
+ *
+ * Mirrors `/\/+$/` exactly, including the degenerate `'https://'` -> `'https:'`:
+ * stripping is unconditional, so a URL that is nothing but a scheme loses its `//`.
+ */
+export function stripTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/')
+        end -= 1;
+    return value.slice(0, end);
+}
+//# sourceMappingURL=text.js.map

package/dist/internal/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/internal/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,IAAI,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}