@zanii/blackbox 0.22.0 → 0.23.0

package/dist/fleet/index.js

@@ -10,6 +10,37 @@ import { authorityTimeline } from "../authority/index.js";
 import { formatAed, sessionCost, toAedFils } from "../cost/index.js";
 import { callsOf } from "../reconcile/record.js";
 import { canonical } from "../reconcile/shared.js";
+const PROMPT_NAME = /^[A-Za-z0-9._-]{1,128}$/;
+/** spec/evals.md §4-§5: the first prompt version a run declared, and its experiment's arm. */
+function promptOf(evs) {
+    const named = (name, version) => typeof name === "string" &&
+        PROMPT_NAME.test(name) &&
+        typeof version === "number" &&
+        Number.isSafeInteger(version) &&
+        version >= 1;
+    for (const e of evs) {
+        const m = e.meta;
+        if (e.kind === "control" &&
+            m.action === "experiment" &&
+            typeof m.experiment === "string" &&
+            typeof m.arm === "string" &&
+            named(m.prompt, m.version))
+            return {
+                prompt_version: {
+                    name: m.prompt,
+                    version: m.version,
+                    via: "experiment",
+                },
+                experiment: { id: m.experiment, arm: m.arm },
+            };
+        const d = e.data ?? {};
+        if (e.kind === "sdk.event" && m.type === "prompt_version" && named(d.name, d.version))
+            return {
+                prompt_version: { name: d.name, version: d.version, via: "sdk" },
+            };
+    }
+    return {};
+}
 /** An approval id: what a lesson may point at, and nothing else (spec/fleet.md §9). */
 export const APPROVAL_ID = /^apr_[0-9a-f]{18}$/;
 /** spec/fleet.md §9: a Zanii Evolve certificate's digest (`sha256:` + 64 hex, or the 64 hex its
@@ -173,6 +204,7 @@ export function sessionSummary(lines, bodies, prices) {
         ...(humanSteps ? { human_steps: humanSteps } : {}),
         ...(selfChanges.length ? { self_changes: selfChanges } : {}),
         ...(decided ? { approvals } : {}),
+        ...promptOf(evs),
     };
 }
 const T = {
@@ -350,6 +382,24 @@ function resourceOf(tool, args) {
     }
     return undefined;
 }
+/** A session's changes (spec/fleet.md §4): each changing tool call and its resource, by seq. */
+export function resourceChanges(lines, bodies) {
+    const touches = [];
+    for (const t of toolCallsOf(callsOf(lines, bodies))) {
+        const res = resourceOf(t.tool, t.args);
+        if (res !== undefined)
+            touches.push({ seq: t.seq, tool: t.tool, resource: res });
+    }
+    for (const line of lines) {
+        const e = JSON.parse(line);
+        if (e.kind !== "tool.call" || e.meta.method !== "tools/call" || typeof e.meta.tool !== "string")
+            continue;
+        const res = resourceOf(e.meta.tool, mcpArgs(bodies(e.body_hash)));
+        if (res !== undefined)
+            touches.push({ seq: e.seq, tool: e.meta.tool, resource: res });
+    }
+    return touches.sort((a, b) => a.seq - b.seq);
+}
 /** Changes to the same resource from two or more sessions (A7), by resource; each session's first change. */
 export function collisions(records) {
     const by = new Map();
@@ -363,23 +413,7 @@ export function collisions(records) {
         if (r.lines.length === 0)
             continue;
         const sid = JSON.parse(r.lines[0]).session_id;
-        const touches = [];
-        for (const t of toolCallsOf(callsOf(r.lines, r.bodies))) {
-            const res = resourceOf(t.tool, t.args);
-            if (res !== undefined)
-                touches.push({ seq: t.seq, tool: t.tool, resource: res });
-        }
-        for (const line of r.lines) {
-            const e = JSON.parse(line);
-            if (e.kind !== "tool.call" ||
-                e.meta.method !== "tools/call" ||
-                typeof e.meta.tool !== "string")
-                continue;
-            const res = resourceOf(e.meta.tool, mcpArgs(r.bodies(e.body_hash)));
-            if (res !== undefined)
-                touches.push({ seq: e.seq, tool: e.meta.tool, resource: res });
-        }
-        for (const t of touches.sort((a, b) => a.seq - b.seq))
+        for (const t of resourceChanges(r.lines, r.bodies))
             touch(t.resource, sid, t.tool, t.seq);
     }
     return [...by.keys()]
@@ -498,6 +532,12 @@ export function signCertificate(cert, did, seed) {
     const sig = signBytes(null, unsigned(cert), key).toString("hex");
     return { ...cert, signed: { by: did, sig: `ed25519:${sig}` } };
 }
+/** spec/anchoring.md §15: `signCertificate` with a key held outside the process (`sign` returns
+ * the raw 64-byte Ed25519 signature). Same bytes as `signCertificate` with the same key. */
+export async function signCertificateWith(cert, did, sign) {
+    const sig = Buffer.from(await sign(unsigned(cert))).toString("hex");
+    return { ...cert, signed: { by: did, sig: `ed25519:${sig}` } };
+}
 /** Checks a signed certificate offline, from the signer's did:key alone. */
 export function verifyCertificate(cert, expectedDid) {
     const s = cert.signed;

package/dist/fleet/insights.js

@@ -181,9 +181,12 @@ function value(v) {
 const isMoment = (e) => {
     const meta = e.meta;
     const status = meta?.status;
-    // an allowed policy check (one per local tool call) is routine, not a moment
+    // an allowed policy check (one per local tool call) is routine, not a moment; so is an
+    // allowed guard decision (spec/guard.md §8)
     if (e.kind === "control" && meta?.action === "policy_check" && meta.decision === "allow")
         return false;
+    if (e.kind === "control" && meta?.action === "guard" && meta.verdict === "allow")
+        return false;
     return (e.kind === "finding" ||
         e.kind === "control" ||
         e.kind === "outcome" ||

package/dist/health/index.js

@@ -5,6 +5,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { createConfirmation, jcsHash } from "@zanii/core";
 import { verifyConfirmation } from "../approvals/index.js";
+import { envelopesOf } from "../reconcile/record.js";
 import { canonical } from "../reconcile/shared.js";
 const TAG = /^sha256:[0-9a-f]{64}$/;
 const HEX64 = /^[0-9a-f]{64}$/;
@@ -180,8 +181,7 @@ export function healthFindings(lines, bodies, closing = false) {
     const recommendations = [];
     const confirmed = new Set();
     let closed = closing;
-    for (const l of lines) {
-        const e = JSON.parse(l);
+    for (const e of envelopesOf(lines)) {
         if (e.kind === "session.close")
             closed = true;
         if (e.kind !== "sdk.event" || !String(e.meta.type).startsWith("health."))

package/dist/hooks/ai-sdk.d.ts

@@ -12,31 +12,29 @@ type Part = {
     input?: unknown;
 };
 /** For `wrapLanguageModel({ model, middleware })`: every generate and stream is observed; what the
- *  model returns reaches the app unchanged. */
-export declare function blackboxMiddleware(sink: EventSink): {
-    wrapGenerate({ doGenerate, model, }: {
-        doGenerate: () => Promise<{
-            content?: Part[];
-            response?: {
-                id?: string;
-                modelId?: string;
-            };
-        }>;
-        model?: ModelInfo;
-    }): Promise<{
+ *  model returns reaches the app unchanged. `toolCalls: false` leaves the tool calls the model asks
+ *  for to a hook that sees them run (Mastra's exporter, G21). */
+export declare function blackboxMiddleware(sink: EventSink, options?: {
+    toolCalls?: boolean;
+}): {
+    specificationVersion: "v3";
+    wrapGenerate<R extends {
         content?: Part[];
         response?: {
             id?: string;
             modelId?: string;
         };
-    }>;
-    wrapStream({ doStream, model, }: {
-        doStream: () => Promise<{
-            stream: ReadableStream<Part>;
-        }>;
+    }>({ doGenerate, model }: {
+        doGenerate: () => PromiseLike<R>;
         model?: ModelInfo;
-    }): Promise<{
+    }): Promise<R>;
+    wrapStream<S extends {
         stream: ReadableStream<Part>;
-    }>;
+    }, P extends Part>({ doStream, model, }: {
+        doStream: () => PromiseLike<S & {
+            stream: ReadableStream<P>;
+        }>;
+        model?: ModelInfo;
+    }): Promise<S>;
 };
 export {};

package/dist/hooks/ai-sdk.js

@@ -29,15 +29,20 @@ function reportTool(sink, p) {
     });
 }
 /** For `wrapLanguageModel({ model, middleware })`: every generate and stream is observed; what the
- *  model returns reaches the app unchanged. */
-export function blackboxMiddleware(sink) {
+ *  model returns reaches the app unchanged. `toolCalls: false` leaves the tool calls the model asks
+ *  for to a hook that sees them run (Mastra's exporter, G21). */
+export function blackboxMiddleware(sink, options = {}) {
+    const tools = options.toolCalls ?? true;
     return {
-        async wrapGenerate({ doGenerate, model, }) {
+        // AI SDK 6 types its middleware by the model spec it wraps; AI SDK 5 ignores the field (G21)
+        specificationVersion: "v3",
+        async wrapGenerate({ doGenerate, model }) {
             const result = await doGenerate();
             neverThrow(() => {
                 reportCall(sink, model, result.response?.id, result.response?.modelId);
-                for (const p of result.content ?? [])
-                    reportTool(sink, p);
+                if (tools)
+                    for (const p of result.content ?? [])
+                        reportTool(sink, p);
             });
             return result;
         },
@@ -51,12 +56,13 @@ export function blackboxMiddleware(sink) {
                             reported = true;
                             reportCall(sink, model, chunk.id, chunk.modelId);
                         }
-                        reportTool(sink, chunk);
+                        if (tools)
+                            reportTool(sink, chunk);
                     });
                     controller.enqueue(chunk);
                 },
             }));
-            return { stream: observed, ...rest };
+            return { ...rest, stream: observed };
         },
     };
 }

package/dist/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { blackboxMiddleware } from "./ai-sdk.ts";
 export { BlackboxAgentHooks, blackboxAgentHooks } from "./claude-agent-sdk.ts";
 export { BlackboxCallbackHandler, type BlackboxCallbacks, blackboxCallbacks } from "./langchain.ts";
+export { blackboxMastraExporter } from "./mastra.ts";
 export { type MemorySink, type TrackMemoryOptions, trackMemory } from "./memory.ts";
 export { attachBlackbox } from "./openai-agents.ts";
 export { llmIdsOf, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI } from "./providers.ts";

package/dist/hooks/index.js

@@ -4,6 +4,7 @@
 export { blackboxMiddleware } from "./ai-sdk.js";
 export { BlackboxAgentHooks, blackboxAgentHooks } from "./claude-agent-sdk.js";
 export { BlackboxCallbackHandler, blackboxCallbacks } from "./langchain.js";
+export { blackboxMastraExporter } from "./mastra.js";
 export { trackMemory } from "./memory.js";
 export { attachBlackbox } from "./openai-agents.js";
 export { llmIdsOf, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI } from "./providers.js";

package/dist/hooks/mastra.d.ts

@@ -0,0 +1,26 @@
+import { type EventSink } from "./shared.ts";
+interface Span {
+    type?: string;
+    name?: string;
+    entityName?: string;
+    entityId?: string;
+    input?: unknown;
+    attributes?: object;
+    errorInfo?: {
+        message?: string;
+        name?: string;
+    };
+    isEvent?: boolean;
+}
+interface TracingEvent {
+    type?: string;
+    exportedSpan?: Span;
+}
+/** For `exporters: [...]` in a Mastra observability config. Records only; never throws. */
+export declare function blackboxMastraExporter(sink: EventSink): {
+    name: string;
+    exportTracingEvent(event: TracingEvent): Promise<void>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+};
+export {};

package/dist/hooks/mastra.js

@@ -0,0 +1,63 @@
+// Mastra (G21, spec/sdk.md §5): an observability exporter that turns Mastra's tracing spans into
+// session events: agent runs, tool calls and their results, model-call failures. Typed structurally
+// on Mastra's `ObservabilityExporter`: no dependency on `@mastra/core`.
+//
+//   import { Observability } from "@mastra/observability";
+//   new Mastra({ agents, observability: new Observability({ configs: { blackbox: {
+//     serviceName: "payments", exporters: [blackboxMastraExporter(session)] } } }) });
+//
+// Mastra's spans carry the provider's response id of a generation's last model call only, so the
+// model-call ids come from the AI SDK middleware on the agent's model (ai-sdk.ts), with its own
+// tool-call reports off (this exporter records the tool calls as they run):
+//   model: wrapLanguageModel({ model, middleware: blackboxMiddleware(session, { toolCalls: false }) })
+import { neverThrow } from "./shared.js";
+const MAX_ERROR = 500;
+const str = (v) => (typeof v === "string" && v ? v : undefined);
+/** For `exporters: [...]` in a Mastra observability config. Records only; never throws. */
+export function blackboxMastraExporter(sink) {
+    const record = ({ type, exportedSpan: span }) => {
+        if (!span)
+            return;
+        const a = (span.attributes ?? {});
+        const name = (span.entityName ?? span.entityId ?? span.name ?? "").slice(0, 256);
+        const callId = str(a.toolCallId);
+        const ids = callId ? { call_id: callId } : {};
+        const tool = span.type === "tool_call" || span.type === "mcp_tool_call";
+        if (type === "span_started") {
+            if (span.type === "agent_run")
+                sink.event("step", name || "agent", {});
+            else if (tool)
+                sink.event("tool.call", name || "tool", {
+                    ...ids,
+                    ...(span.input === undefined ? {} : { args: span.input }),
+                });
+            return;
+        }
+        if (type !== "span_ended")
+            return;
+        if (tool) {
+            const failed = span.errorInfo !== undefined || a.success === false;
+            sink.event("tool.result", name || "tool", {
+                ok: !failed,
+                ...ids,
+                ...(span.errorInfo
+                    ? { error: String(span.errorInfo.message ?? "").slice(0, MAX_ERROR) }
+                    : {}),
+            });
+        }
+        else if (span.type === "model_generation" && span.errorInfo) {
+            sink.event("llm.error", undefined, {
+                error: String(span.errorInfo.message ?? "").slice(0, MAX_ERROR),
+                type: span.errorInfo.name ?? "Error",
+            });
+        }
+    };
+    return {
+        name: "zanii-blackbox",
+        async exportTracingEvent(event) {
+            neverThrow(() => record(event));
+        },
+        async flush() { },
+        async shutdown() { },
+    };
+}

package/dist/index.d.ts

@@ -1,27 +1,34 @@
+export { publicKeyFromDid } from "@zanii/core";
 export { A2A_STREAMING, type AgentCardReport, a2aMethod, a2aRequestMeta, a2aResponseMeta, a2aRestMethod, a2aRestRequestMeta, a2aRestResponseMeta, agentCardDigest, agentCardPayload, gatewayCardKey, rewriteAgentCard, verifyAgentCard, } from "./a2a/index.ts";
 export { type Action, actionsFromCalls, actionsOf, actionsPage, type Reasoning, } from "./actions/index.ts";
 export { ACCREDITATION_TYPE, type AccreditationRefusal, checkAccreditation, checkRegister, docHash, REGISTER_TYPE, SERVICE_ID, type ServiceRow, serviceTier, } from "./admission/index.ts";
 export { causality, memoryXray } from "./agents/index.ts";
+export { type AcceptedEntry, acceptedHash, acceptedMatch, checkAcceptedFindings, } from "./analysis/accepted.ts";
 export { type DetectorOptions, detectors, fingerprint } from "./analysis/detectors.ts";
 export { FAULTS, type Fault, faultOf } from "./analysis/faults.ts";
-export { type Accuracy, type AnalyzeOptions, type AnswerClaims, analyze, answerClaims, answerCredential, answerRisk, answersOf, answerText, type ClaimEntry, type ClaimVerdict, type CriterionResult, canonicalNumber, checkAgainstPacks, checkFlightPlan, checkpointReplay, detectorAccuracy, dualWitness, Evidence, eventsOf, type Fact, type Finding as AnalysisFinding, factsIn, findingKey, type GroundedClaim, groundingFindings, groundingRequest, growth, HOLD_TRIGGERS, identifiersIn, isoWeek, judgeFindings, judgeRequest, type Label as AccuracyLabel, type Landing, landing, lessons, loadReferencePacks, modelGroundingFindings, normaliseValue, OUTCOMES, type Outcome, type OutcomeRollup, packsFor, parseGroundingAnswer, parseJudgeAnswer, promptChanged, type ReferenceFact, type ReferencePack, type ReferenceVerdict, referenceContext, rollup, type Severity, schemaProblem, secretSent, selfChanges, successRange, systemPromptHash, toolDrifted, toolHallucinations, toolsHash, userDownvotes, verifyAnswerCredential, type WasteReason, type WasteReport, waste, wilsonLow, } from "./analysis/index.ts";
+export { type GuardCall, type GuardConfig, type GuardFinding, type GuardMode, type GuardState, type GuardToolResult, type GuardVerdict, guardCheck, guardMode, guardObserve, guardPin, guardState, guardToolResults, loadGuardConfig, } from "./analysis/guard.ts";
+export { type Accuracy, type AnalyzeOptions, Analyzer, type AnswerClaims, analyze, answerClaims, answerCredential, answerRisk, answersOf, answerText, type ClaimEntry, type ClaimVerdict, type CriterionResult, canonicalNumber, checkAgainstPacks, checkFlightPlan, checkpointReplay, detectorAccuracy, dualWitness, Evidence, elicitationSecret, eventsOf, type Fact, type Finding as AnalysisFinding, factsIn, findingKey, type GroundedClaim, groundingFindings, groundingRequest, growth, HOLD_TRIGGERS, identifiersIn, isoWeek, judgeFindings, judgeRequest, type Label as AccuracyLabel, type Landing, landing, lessons, loadReferencePacks, modelGroundingFindings, normaliseValue, OUTCOMES, type Outcome, type OutcomeRollup, packsFor, parseGroundingAnswer, parseJudgeAnswer, promptChanged, type ReferenceFact, type ReferencePack, type ReferenceVerdict, referenceContext, rollup, type Severity, schemaProblem, secretSent, selfChanges, successRange, systemPromptHash, toolDrifted, toolHallucinations, toolsHash, userDownvotes, verifyAnswerCredential, type WasteReason, type WasteReport, waste, wilsonLow, } from "./analysis/index.ts";
 export { injectionFindings, injectionRule } from "./analysis/injection.ts";
+export { checkPredicate, checkSchema, compilePattern, milliOf, patternMatches, schemaError, } from "./analysis/plan-checks.ts";
 export { MITRE_ATLAS, OWASP_ASI, TAXONOMY, type Taxonomy, taxonomyOf, } from "./analysis/taxonomy.ts";
-export { type ApprovalFinding, approvalConfirmation, approvalFindings, argsHash, verifyConfirmation, } from "./approvals/index.ts";
+export { type ApprovalFinding, approvalConfirmation, approvalConfirmationWith, approvalFindings, argsHash, verifyConfirmation, } from "./approvals/index.ts";
 export { textWarnings } from "./approvals/warnings.ts";
 export { type ArchiveFile, type ArchiveManifest, type ArchiveReport, archiveDigest, archiveEntry, archiveManifest, verifyArchive, } from "./archive/index.ts";
 export { archiveParquet } from "./archive/parquet.ts";
 export { type Attestation, attest, isReadOnly, normalise, parseCommand } from "./attest/index.ts";
 export { type AuthorityFinding, authorityAt, authorityTimeline, automationSurprise, type Mode as AuthorityMode, type Span as AuthoritySpan, } from "./authority/index.ts";
+export { type ActiveClearance, type ApproverStat, agentReportFindings, approverFatigueFindings, approverStats, type Check, type CheckStatus, type ClearanceAnswer, type ClearanceDecision, type ClearanceMode, type Currency, checkChecks, checkEnvelope, checkFindings, checkHazardRegister, checkNotam, checkOperatorCertificate, checkOpspecs, checkSafetyReport, checkStatus, clearance, clearanceFindings, commitPointSeq, configurationId, type EnvelopeChange, type EnvelopeLimits, envelopeFindings, globMatch, type Hazard, type HazardRegister, hazardStatus, isLevel, LEVELS, type Level, type LoadSheet, type Locator, loadSheet, locator, locatorFindings, type Notam, notamFindings, notamsInForce, type OperatorFacts, type OpSpecs, operatorCertificate, opspecsCheck, type Procedure, pastCommitPoint, procedureFor, protectReasoning, QRH, type ReasoningRequest, ratingCurrency, ratingLapsed, reasoningStatus, SAFETY_CATEGORIES, safetyReportSummary, samePerson, shapeRequest, type TypeCertificate, typeCertificate, unapprovedModifications, } from "./aviation/index.ts";
 export { badgeSvg, RECORD_STATES, type RecordState, recordBadge, recordState, } from "./badge/index.ts";
 export { type Invoice, type InvoiceLine, invoice, loadPlans, type Plan, type Plans, renderTaxCreditNote, renderTaxInvoice, stripeSignatureOk, type TaxCreditNote, type TaxCreditNoteInput, type TaxInvoice, type TaxInvoiceInput, taxCreditNote, taxInvoice, } from "./billing/index.ts";
 export { type AgentIdentity, checkAgent, sessionBom } from "./bom/index.ts";
+export { type AgentBudget, type AgentBudgets, agentBudgetFindings, budgetFor, mad, median, type Period as BudgetPeriod, parseAgentBudgets, peerFindings, periodOf, type UsageRow, } from "./budgets/index.ts";
 export { BlackboxApiError, type Client, type ClientOptions, client, type SessionQuery, } from "./client/index.ts";
 export { ART12_MIN_RETENTION_DAYS, type Art12Check, type Art12Report, art12Check, } from "./compliance/art12.ts";
 export { accuracyFact, complianceFacts, complianceReport, controlsFact, type Facts, type Framework, hallucinationFacts, type Report as ComplianceReport, renderReport, } from "./compliance/index.ts";
 export { renderZaniiCompliance, type ZaniiComplianceReport, zaniiCompliance, } from "./compliance/zanii.ts";
 export { type Constitution, type ConstitutionRule, constitutionHash, createConstitution, evaluateConstitution, governanceOf, verifyConstitution, } from "./constitution/index.ts";
-export { type CallCost, type CostReport, callMicroUsd, effectivePrice, formatAed, type LoadedPrices, loadPrices, type ModelPrice, type PriceTable, priceCall, priceFor, promptTokens, requestsOf, sessionCost, type Tokens, toAedFils, tokensOf, } from "./cost/index.ts";
+export { type BatchEntry, type BatchItem, type BatchReport, batchReport, } from "./cost/batch.ts";
+export { batchModels, type CallCost, type CostReport, callMicroUsd, effectivePrice, formatAed, type LoadedPrices, loadPrices, type ModelPrice, type PriceTable, priceCall, priceFor, promptTokens, requestsOf, sessionCost, type Tokens, toAedFils, tokensOf, } from "./cost/index.ts";
 export { agentCv, buildCv, cvHash, verifyCv } from "./cv/index.ts";
 export { type AuditRow, CORE_EVIDENCE, CORE_IDENTIFIERS, type Connector as AuditConnector, canaryIdentifier, checkAuditConnector, type DataFinding, type DataRules, dataClasses, dataFindings, dataFingerprint, dataMeta, dataScan, dataTopology, hasEvidence, type Identifier, type Lineage, lineage, luhn, normalizeValue, parseAuditLog, parseCsv, reconcileSystem, type SystemReport, type Topology, toolWitness, unevidenced, verifyToolWitness, witnessOf, } from "./data/index.ts";
 export { type Directive, type DirectiveItem, type DirectiveOptions, directives, fleetDirectives, } from "./directives/index.ts";
@@ -29,26 +36,30 @@ export { argumentLeaves, type Disclosure, type DisclosureEnvelope, discloseField
 export { checkDrill, drillReport, type Fault as DrillFault } from "./drills/index.ts";
 export { checkDuty, type DutyFinding, type DutyLimits, dutyFindings } from "./duty/index.ts";
 export { openSegments, type SealedSegment } from "./encryption/index.ts";
+export { type Arm, armStats, assignArm, type CaseScore, casesFromScenarios, casesFromSessions, checkDataset, checkExperiment, checkScorer, compareRuns, datasetHash, type EvalCase, experimentResults, type Observation, parseCasesJsonl, promptResults, promptSha256, type RunSummary, runSummary, SCORERS, type Scorer, scoreCase, toMilli, } from "./evals/index.ts";
 export { type EvidencePack, type EvidencePackOptions, evidencePack, renderEvidencePack, } from "./evidence/index.ts";
-export { buildEquivocationProof, compareViews, cosignLedgerSth, verifyEquivocationProof, verifyLedgerCosignature, } from "./federation/index.ts";
+export { buildEquivocationProof, compareViews, cosignLedgerSth, cosignLedgerSthWith, verifyEquivocationProof, verifyLedgerCosignature, } from "./federation/index.ts";
 export { buildOwnerAttestation, buildPayment, CURRENCIES, FTA_WALL_ID, financeFindings, formatMoney, ftaPayload, parseMoney, paymentsOf, screenCounterparty, screeningPayload, verifyOwnerAttestation, verifyOwnerBinding, } from "./finance/index.ts";
-export { APPROVAL_ID, aggregateFindings, airworthiness, type Collision, certificateOf, collisions, didFromSeed, type FindingGroup, incidentReport, logbook, type Summary, sessionSummary, signatureOf, signatures, signCertificate, taughtBy, verifyCertificate, } from "./fleet/index.ts";
+export { APPROVAL_ID, aggregateFindings, airworthiness, type Collision, certificateOf, collisions, didFromSeed, type FindingGroup, incidentReport, logbook, type Summary, sessionSummary, signatureOf, signatures, signCertificate, signCertificateWith, taughtBy, verifyCertificate, } from "./fleet/index.ts";
 export { copilotContext, copilotPrompt, type Insights, insights, parseCopilotAnswer, } from "./fleet/insights.ts";
 export { type AppealItem, type AppealPack, appealPack, decisionPayload, GOV_DECISION_KINDS, renderAppealPack, ruleConsistency, signSubjectClaim, subjectTag, verifyDecision, verifyFactors, verifySubjectClaim, } from "./gov/index.ts";
 export { accessPayload, breakGlass, checkEpisodeTag, clinicianConfirmation, type EpisodeItem, episodeSeed, episodesPack, episodeTag, healthFindings, protocolTrail, recommendationHash, recommendationPayload, verifyCommitment, verifyHealthSignature, } from "./health/index.ts";
-export { attachBlackbox, BlackboxAgentHooks, BlackboxCallbackHandler, type BlackboxCallbacks, blackboxAgentHooks, blackboxCallbacks, blackboxMiddleware, type EventSink, llmIds, llmIdsOf, trackMemory, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI, } from "./hooks/index.ts";
+export { attachBlackbox, BlackboxAgentHooks, BlackboxCallbackHandler, type BlackboxCallbacks, blackboxAgentHooks, blackboxCallbacks, blackboxMastraExporter, blackboxMiddleware, type EventSink, llmIds, llmIdsOf, trackMemory, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI, } from "./hooks/index.ts";
 export { type AgentSink, BlackboxStoppedError, blackboxAgentMiddleware, blackboxHitl, type HitlRequest, } from "./hooks/langchain-agent.ts";
 export { blackboxCheckpointer } from "./hooks/langgraph-checkpoint.ts";
 export { MANAGED_END, MANAGED_START, managedBlock, protectedEdit } from "./hooks/protect.ts";
 export { type Investigation, investigation, renderInvestigation, } from "./investigate/index.ts";
+export { isRpcResponse, rpcIdOf, SERVER_REQUESTS, type ServerRequestKind, secretFields, serverReplyMeta, serverRequestMeta, } from "./mcp-requests/index.ts";
 export { type McpWrapOptions, mcpWrap } from "./mcp-wrap/index.ts";
 export { commitContent, memoryChain, memoryEntry, verifyMemoryContent, verifyMemoryEntry, } from "./memory/index.ts";
 export { type AmountUnit, anthropicStatement, type Baseline, baselines, type Connector, checkConnector, checkStatement, csvStatement, customStatement, decimalToMicroUsd, fuel, fxRate, fxUnit, modelSpend, openaiStatement, pageParams, parseXml, reconcileBilling, requestFor, resolvePath, type Statement, } from "./money/index.ts";
 export { deadlinesDue, filingPack, type OccurrenceFacts, type OccurrenceFramework, type OccurrenceReport, occurrenceFacts, occurrenceReport, renderOccurrence, } from "./occurrence/index.ts";
 export { ingestOcsf, type OcsfEvent, type OcsfVersion, ocsfLine, toOcsf } from "./ocsf/index.ts";
-export { fromOtlp, type OtlpEvent, toOtlp } from "./otlp/index.ts";
-export { otlpFromProtobuf } from "./otlp/protobuf.ts";
+export { fromOtlp, fromOtlpLogs, fromOtlpMetrics, type GatewayCall, gatewayTrace, microOf, type OtlpEvent, toOtlp, toOtlpLogs, toOtlpMetrics, } from "./otlp/index.ts";
+export { otlpDecode, otlpEncode, otlpFromProtobuf, type Signal as OtlpSignal, } from "./otlp/protobuf.ts";
 export { checkIdentifier, checkPack, corePack, type PackEntry, packData, packFrameworks, } from "./packs/index.ts";
+export { shapeArabic, type UnicodeTables, visualLine, } from "./pdf/arabic.ts";
+export { type ArabicAssets, type ArabicMetrics, type FontMetrics, type PdfAssets, type PdfAttachment, type PdfInput, type PdfVerification, pdfCertificate, reportPdf, verifyPdf, } from "./pdf/index.ts";
 export { type PolicyChange, type PolicyDelta, policyDelta } from "./policy/delta.ts";
 export { type Draft, type DraftGroup, policyDrafts } from "./policy/drafts.ts";
 export { audited, type CompiledPolicy, compilePolicy, type Decision, decide, ENVIRONMENT, environmentOf, loadPolicy, mcpToolHints, type Policy, policyFindings, type Rule, type ToolHints, toolDefinitionHash, } from "./policy/index.ts";
@@ -59,6 +70,7 @@ export { type InterventionEvidence, interventionEvidence, interventionGain, } fr
 export { activities, buildNormal, type NormalModel, type NormalScore, normalScore, normalThreshold, } from "./precog/normal.ts";
 export { type PreflightFinding, preflightFindings } from "./preflight/index.ts";
 export { type Rating, type TypeUnratedFinding, typeRatings, typeUnrated, } from "./ratings/index.ts";
+export { type RealtimeFormat, type RealtimeFrame, realtimeFrame, realtimeModelFromPath, } from "./realtime/index.ts";
 export { type Finding, type FindingCode, type Harness, loadLocal, type ReconcileOptions, RecordNotVerified, type Report, reconcile, } from "./reconcile/index.ts";
 /** Canonical JSON (keys sorted, no whitespace, JavaScript number formatting), as hashed. */
 export { canonical } from "./reconcile/shared.ts";
@@ -72,10 +84,11 @@ export { assembleSla, assessCompliance, buildSlaBody, signSla, slaHash, verifySl
 export { assembleSuccession, buildSuccessionBody, type Succession, type SuccessionBody, type SuccessionReason, signSuccession, successionHash, verifyLineage, verifySuccession, } from "./succession/index.ts";
 export { type TimestampReport, timestampRequest, verifyTimestamp, } from "./timestamp/index.ts";
 export { resolveToken, resolveTokens, tokenFor } from "./tokens/index.ts";
-export { addCheckpointBody, type Cbor, cborDecode, cborEncode, checkpointText, consistencyProof, cosign, cosignMldsa, ed25519PublicKey, inclusionProof, keyRotationNote, leafHash, logKid, makeReceipt, merkleRoot, mldsaAvailable, mldsaPublicKey, noteVkey, parseAddCheckpoint, parseCheckpoint, parseVkey, RECEIPT_SUB, SESSION_CONTENT_TYPE, sessionStatement, signNote, signStatement, splitNote, statementEntry, subtreeMessage, transparentStatement, verifyConsistency, verifyCoseSign1, verifyCosignature, verifyInclusion, verifyKeyRotation, verifyNote, verifyReceipt, verifyTransparency, } from "./transparency/index.ts";
+export { addCheckpointBody, type Cbor, cborDecode, cborEncode, checkpointText, consistencyProof, cosign, cosignMldsa, ed25519PublicKey, ed25519Sign, ed25519Verify, inclusionProof, keyRotationNote, leafHash, logKid, makeReceipt, merkleRoot, mldsaAvailable, mldsaPublicKey, noteVkey, parseAddCheckpoint, parseCheckpoint, parseVkey, RECEIPT_SUB, SESSION_CONTENT_TYPE, sessionStatement, signNote, signStatement, splitNote, statementEntry, subtreeMessage, transparentStatement, verifyConsistency, verifyCoseSign1, verifyCosignature, verifyInclusion, verifyKeyRotation, verifyNote, verifyReceipt, verifyTransparency, } from "./transparency/index.ts";
 export { type Compensation, checkCompensations, runUndo, type UndoFinding, type UndoStatus, type UndoStep, undoFindings, undoPlan, } from "./undo/index.ts";
 export * from "./verify/index.ts";
 export { VERSION } from "./version.ts";
 export { checkOutput, WALLS, type Wall, wallFindings, wallManifestHash, } from "./walls/index.ts";
+export { WAREHOUSE_TABLES, type WarehouseCost, type WarehouseDestination, type WarehouseRequest, type WarehouseRow, type WarehouseSession, type WarehouseTable, warehouseBatches, warehouseRequest, warehouseRequestId, warehouseRows, } from "./warehouse/index.ts";
 export { type Conditions, type Sample, weather } from "./weather/index.ts";
 export { postReceipt, receiptFor, type Tree, workspaceTree } from "./workspace-receipt/index.ts";

package/dist/index.js

@@ -1,29 +1,37 @@
 // Public API of @zanii/blackbox. Everything customers can import is re-exported here.
 // Keep this file in step with sdks/python/src/zanii_blackbox/__init__.py (the SDKs mirror each other).
+// spec/anchoring.md §15: the servers check an outside signer against the identity's did:key
+export { publicKeyFromDid } from "@zanii/core";
 export { A2A_STREAMING, a2aMethod, a2aRequestMeta, a2aResponseMeta, a2aRestMethod, a2aRestRequestMeta, a2aRestResponseMeta, agentCardDigest, agentCardPayload, gatewayCardKey, rewriteAgentCard, verifyAgentCard, } from "./a2a/index.js";
 export { actionsFromCalls, actionsOf, actionsPage, } from "./actions/index.js";
 export { ACCREDITATION_TYPE, checkAccreditation, checkRegister, docHash, REGISTER_TYPE, SERVICE_ID, serviceTier, } from "./admission/index.js";
 export { causality, memoryXray } from "./agents/index.js";
+export { acceptedHash, acceptedMatch, checkAcceptedFindings, } from "./analysis/accepted.js";
 export { detectors, fingerprint } from "./analysis/detectors.js";
 export { FAULTS, faultOf } from "./analysis/faults.js";
-export { analyze, answerClaims, answerCredential, answerRisk, answersOf, answerText, canonicalNumber, checkAgainstPacks, checkFlightPlan, checkpointReplay, detectorAccuracy, dualWitness, Evidence, eventsOf, factsIn, findingKey, groundingFindings, groundingRequest, growth, HOLD_TRIGGERS, identifiersIn, isoWeek, judgeFindings, judgeRequest, landing, lessons, loadReferencePacks, modelGroundingFindings, normaliseValue, OUTCOMES, packsFor, parseGroundingAnswer, parseJudgeAnswer, promptChanged, referenceContext, rollup, schemaProblem, secretSent, selfChanges, successRange, systemPromptHash, toolDrifted, toolHallucinations, toolsHash, userDownvotes, verifyAnswerCredential, waste, wilsonLow, } from "./analysis/index.js";
+export { guardCheck, guardMode, guardObserve, guardPin, guardState, guardToolResults, loadGuardConfig, } from "./analysis/guard.js";
+export { Analyzer, analyze, answerClaims, answerCredential, answerRisk, answersOf, answerText, canonicalNumber, checkAgainstPacks, checkFlightPlan, checkpointReplay, detectorAccuracy, dualWitness, Evidence, elicitationSecret, eventsOf, factsIn, findingKey, groundingFindings, groundingRequest, growth, HOLD_TRIGGERS, identifiersIn, isoWeek, judgeFindings, judgeRequest, landing, lessons, loadReferencePacks, modelGroundingFindings, normaliseValue, OUTCOMES, packsFor, parseGroundingAnswer, parseJudgeAnswer, promptChanged, referenceContext, rollup, schemaProblem, secretSent, selfChanges, successRange, systemPromptHash, toolDrifted, toolHallucinations, toolsHash, userDownvotes, verifyAnswerCredential, waste, wilsonLow, } from "./analysis/index.js";
 export { injectionFindings, injectionRule } from "./analysis/injection.js";
+export { checkPredicate, checkSchema, compilePattern, milliOf, patternMatches, schemaError, } from "./analysis/plan-checks.js";
 export { MITRE_ATLAS, OWASP_ASI, TAXONOMY, taxonomyOf, } from "./analysis/taxonomy.js";
-export { approvalConfirmation, approvalFindings, argsHash, verifyConfirmation, } from "./approvals/index.js";
+export { approvalConfirmation, approvalConfirmationWith, approvalFindings, argsHash, verifyConfirmation, } from "./approvals/index.js";
 export { textWarnings } from "./approvals/warnings.js";
 export { archiveDigest, archiveEntry, archiveManifest, verifyArchive, } from "./archive/index.js";
 export { archiveParquet } from "./archive/parquet.js";
 export { attest, isReadOnly, normalise, parseCommand } from "./attest/index.js";
 export { authorityAt, authorityTimeline, automationSurprise, } from "./authority/index.js";
+export { agentReportFindings, approverFatigueFindings, approverStats, checkChecks, checkEnvelope, checkFindings, checkHazardRegister, checkNotam, checkOperatorCertificate, checkOpspecs, checkSafetyReport, checkStatus, clearance, clearanceFindings, commitPointSeq, configurationId, envelopeFindings, globMatch, hazardStatus, isLevel, LEVELS, loadSheet, locator, locatorFindings, notamFindings, notamsInForce, operatorCertificate, opspecsCheck, pastCommitPoint, procedureFor, protectReasoning, QRH, ratingCurrency, ratingLapsed, reasoningStatus, SAFETY_CATEGORIES, safetyReportSummary, samePerson, shapeRequest, typeCertificate, unapprovedModifications, } from "./aviation/index.js";
 export { badgeSvg, RECORD_STATES, recordBadge, recordState, } from "./badge/index.js";
 export { invoice, loadPlans, renderTaxCreditNote, renderTaxInvoice, stripeSignatureOk, taxCreditNote, taxInvoice, } from "./billing/index.js";
 export { checkAgent, sessionBom } from "./bom/index.js";
+export { agentBudgetFindings, budgetFor, mad, median, parseAgentBudgets, peerFindings, periodOf, } from "./budgets/index.js";
 export { BlackboxApiError, client, } from "./client/index.js";
 export { ART12_MIN_RETENTION_DAYS, art12Check, } from "./compliance/art12.js";
 export { accuracyFact, complianceFacts, complianceReport, controlsFact, hallucinationFacts, renderReport, } from "./compliance/index.js";
 export { renderZaniiCompliance, zaniiCompliance, } from "./compliance/zanii.js";
 export { constitutionHash, createConstitution, evaluateConstitution, governanceOf, verifyConstitution, } from "./constitution/index.js";
-export { callMicroUsd, effectivePrice, formatAed, loadPrices, priceCall, priceFor, promptTokens, requestsOf, sessionCost, toAedFils, tokensOf, } from "./cost/index.js";
+export { batchReport, } from "./cost/batch.js";
+export { batchModels, callMicroUsd, effectivePrice, formatAed, loadPrices, priceCall, priceFor, promptTokens, requestsOf, sessionCost, toAedFils, tokensOf, } from "./cost/index.js";
 export { agentCv, buildCv, cvHash, verifyCv } from "./cv/index.js";
 export { CORE_EVIDENCE, CORE_IDENTIFIERS, canaryIdentifier, checkAuditConnector, dataClasses, dataFindings, dataFingerprint, dataMeta, dataScan, dataTopology, hasEvidence, lineage, luhn, normalizeValue, parseAuditLog, parseCsv, reconcileSystem, toolWitness, unevidenced, verifyToolWitness, witnessOf, } from "./data/index.js";
 export { directives, fleetDirectives, } from "./directives/index.js";
@@ -31,26 +39,30 @@ export { argumentLeaves, discloseFields, disclosureEnvelope, verifyDisclosure, v
 export { checkDrill, drillReport } from "./drills/index.js";
 export { checkDuty, dutyFindings } from "./duty/index.js";
 export { openSegments } from "./encryption/index.js";
+export { armStats, assignArm, casesFromScenarios, casesFromSessions, checkDataset, checkExperiment, checkScorer, compareRuns, datasetHash, experimentResults, parseCasesJsonl, promptResults, promptSha256, runSummary, SCORERS, scoreCase, toMilli, } from "./evals/index.js";
 export { evidencePack, renderEvidencePack, } from "./evidence/index.js";
-export { buildEquivocationProof, compareViews, cosignLedgerSth, verifyEquivocationProof, verifyLedgerCosignature, } from "./federation/index.js";
+export { buildEquivocationProof, compareViews, cosignLedgerSth, cosignLedgerSthWith, verifyEquivocationProof, verifyLedgerCosignature, } from "./federation/index.js";
 export { buildOwnerAttestation, buildPayment, CURRENCIES, FTA_WALL_ID, financeFindings, formatMoney, ftaPayload, parseMoney, paymentsOf, screenCounterparty, screeningPayload, verifyOwnerAttestation, verifyOwnerBinding, } from "./finance/index.js";
-export { APPROVAL_ID, aggregateFindings, airworthiness, certificateOf, collisions, didFromSeed, incidentReport, logbook, sessionSummary, signatureOf, signatures, signCertificate, taughtBy, verifyCertificate, } from "./fleet/index.js";
+export { APPROVAL_ID, aggregateFindings, airworthiness, certificateOf, collisions, didFromSeed, incidentReport, logbook, sessionSummary, signatureOf, signatures, signCertificate, signCertificateWith, taughtBy, verifyCertificate, } from "./fleet/index.js";
 export { copilotContext, copilotPrompt, insights, parseCopilotAnswer, } from "./fleet/insights.js";
 export { appealPack, decisionPayload, GOV_DECISION_KINDS, renderAppealPack, ruleConsistency, signSubjectClaim, subjectTag, verifyDecision, verifyFactors, verifySubjectClaim, } from "./gov/index.js";
 export { accessPayload, breakGlass, checkEpisodeTag, clinicianConfirmation, episodeSeed, episodesPack, episodeTag, healthFindings, protocolTrail, recommendationHash, recommendationPayload, verifyCommitment, verifyHealthSignature, } from "./health/index.js";
-export { attachBlackbox, BlackboxAgentHooks, BlackboxCallbackHandler, blackboxAgentHooks, blackboxCallbacks, blackboxMiddleware, llmIds, llmIdsOf, trackMemory, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI, } from "./hooks/index.js";
+export { attachBlackbox, BlackboxAgentHooks, BlackboxCallbackHandler, blackboxAgentHooks, blackboxCallbacks, blackboxMastraExporter, blackboxMiddleware, llmIds, llmIdsOf, trackMemory, wrapAnthropic, wrapBedrock, wrapGemini, wrapOpenAI, } from "./hooks/index.js";
 export { BlackboxStoppedError, blackboxAgentMiddleware, blackboxHitl, } from "./hooks/langchain-agent.js";
 export { blackboxCheckpointer } from "./hooks/langgraph-checkpoint.js";
 export { MANAGED_END, MANAGED_START, managedBlock, protectedEdit } from "./hooks/protect.js";
 export { investigation, renderInvestigation, } from "./investigate/index.js";
+export { isRpcResponse, rpcIdOf, SERVER_REQUESTS, secretFields, serverReplyMeta, serverRequestMeta, } from "./mcp-requests/index.js";
 export { mcpWrap } from "./mcp-wrap/index.js";
 export { commitContent, memoryChain, memoryEntry, verifyMemoryContent, verifyMemoryEntry, } from "./memory/index.js";
 export { anthropicStatement, baselines, checkConnector, checkStatement, csvStatement, customStatement, decimalToMicroUsd, fuel, fxRate, fxUnit, modelSpend, openaiStatement, pageParams, parseXml, reconcileBilling, requestFor, resolvePath, } from "./money/index.js";
 export { deadlinesDue, filingPack, occurrenceFacts, occurrenceReport, renderOccurrence, } from "./occurrence/index.js";
 export { ingestOcsf, ocsfLine, toOcsf } from "./ocsf/index.js";
-export { fromOtlp, toOtlp } from "./otlp/index.js";
-export { otlpFromProtobuf } from "./otlp/protobuf.js";
+export { fromOtlp, fromOtlpLogs, fromOtlpMetrics, gatewayTrace, microOf, toOtlp, toOtlpLogs, toOtlpMetrics, } from "./otlp/index.js";
+export { otlpDecode, otlpEncode, otlpFromProtobuf, } from "./otlp/protobuf.js";
 export { checkIdentifier, checkPack, corePack, packData, packFrameworks, } from "./packs/index.js";
+export { shapeArabic, visualLine, } from "./pdf/arabic.js";
+export { pdfCertificate, reportPdf, verifyPdf, } from "./pdf/index.js";
 export { policyDelta } from "./policy/delta.js";
 export { policyDrafts } from "./policy/drafts.js";
 export { audited, compilePolicy, decide, ENVIRONMENT, environmentOf, loadPolicy, mcpToolHints, policyFindings, toolDefinitionHash, } from "./policy/index.js";
@@ -61,6 +73,7 @@ export { interventionEvidence, interventionGain, } from "./precog/intervention.j
 export { activities, buildNormal, normalScore, normalThreshold, } from "./precog/normal.js";
 export { preflightFindings } from "./preflight/index.js";
 export { typeRatings, typeUnrated, } from "./ratings/index.js";
+export { realtimeFrame, realtimeModelFromPath, } from "./realtime/index.js";
 export { loadLocal, RecordNotVerified, reconcile, } from "./reconcile/index.js";
 /** Canonical JSON (keys sorted, no whitespace, JavaScript number formatting), as hashed. */
 export { canonical } from "./reconcile/shared.js";
@@ -74,10 +87,11 @@ export { assembleSla, assessCompliance, buildSlaBody, signSla, slaHash, verifySl
 export { assembleSuccession, buildSuccessionBody, signSuccession, successionHash, verifyLineage, verifySuccession, } from "./succession/index.js";
 export { timestampRequest, verifyTimestamp, } from "./timestamp/index.js";
 export { resolveToken, resolveTokens, tokenFor } from "./tokens/index.js";
-export { addCheckpointBody, cborDecode, cborEncode, checkpointText, consistencyProof, cosign, cosignMldsa, ed25519PublicKey, inclusionProof, keyRotationNote, leafHash, logKid, makeReceipt, merkleRoot, mldsaAvailable, mldsaPublicKey, noteVkey, parseAddCheckpoint, parseCheckpoint, parseVkey, RECEIPT_SUB, SESSION_CONTENT_TYPE, sessionStatement, signNote, signStatement, splitNote, statementEntry, subtreeMessage, transparentStatement, verifyConsistency, verifyCoseSign1, verifyCosignature, verifyInclusion, verifyKeyRotation, verifyNote, verifyReceipt, verifyTransparency, } from "./transparency/index.js";
+export { addCheckpointBody, cborDecode, cborEncode, checkpointText, consistencyProof, cosign, cosignMldsa, ed25519PublicKey, ed25519Sign, ed25519Verify, inclusionProof, keyRotationNote, leafHash, logKid, makeReceipt, merkleRoot, mldsaAvailable, mldsaPublicKey, noteVkey, parseAddCheckpoint, parseCheckpoint, parseVkey, RECEIPT_SUB, SESSION_CONTENT_TYPE, sessionStatement, signNote, signStatement, splitNote, statementEntry, subtreeMessage, transparentStatement, verifyConsistency, verifyCoseSign1, verifyCosignature, verifyInclusion, verifyKeyRotation, verifyNote, verifyReceipt, verifyTransparency, } from "./transparency/index.js";
 export { checkCompensations, runUndo, undoFindings, undoPlan, } from "./undo/index.js";
 export * from "./verify/index.js";
 export { VERSION } from "./version.js";
 export { checkOutput, WALLS, wallFindings, wallManifestHash, } from "./walls/index.js";
+export { WAREHOUSE_TABLES, warehouseBatches, warehouseRequest, warehouseRequestId, warehouseRows, } from "./warehouse/index.js";
 export { weather } from "./weather/index.js";
 export { postReceipt, receiptFor, workspaceTree } from "./workspace-receipt/index.js";

package/dist/mcp-requests/index.d.ts

@@ -0,0 +1,26 @@
+import type { Json } from "../verify/envelope.ts";
+type Meta = {
+    [key: string]: Json;
+};
+/** The server's request methods and the event kind each is recorded as. */
+export declare const SERVER_REQUESTS: Readonly<Record<string, ServerRequestKind>>;
+export type ServerRequestKind = "tool.sampling" | "tool.elicitation" | "tool.roots";
+/** A JSON-RPC id as recorded: a string of at most 256 characters, or a safe integer. */
+export declare function rpcIdOf(id: unknown): string | number | undefined;
+/** The field names that ask for a credential: the name, lowercased with everything but letters
+ * and digits removed, contains one of the credential words, or is `pin`. In the order given. */
+export declare function secretFields(names: readonly string[]): string[];
+/**
+ * A server → client message that is one of the server's requests: its kind and `meta`, or null
+ * for anything else (a notification, a response, another method, a batch, a request without a
+ * usable id).
+ */
+export declare function serverRequestMeta(message: unknown): {
+    kind: ServerRequestKind;
+    meta: Meta;
+} | null;
+/** The client's reply to a server request of `method`: its `meta` (spec/mcp.md §6). */
+export declare function serverReplyMeta(method: string, message: unknown): Meta;
+/** Whether a client → server message is a reply (a JSON-RPC response) rather than a request. */
+export declare function isRpcResponse(message: unknown): boolean;
+export {};