@agent-inspect/adapter-sdk 2.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentInspect contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,260 @@
+'use strict';
+
+var persisted = require('agent-inspect/persisted');
+var readers = require('agent-inspect/readers');
+
+// packages/adapter-sdk/src/registration.ts
+var registry = /* @__PURE__ */ new Map();
+function createAdapterRegistration(input) {
+  if (!input.id.trim()) throw new Error("adapter id is required");
+  if (!input.name.trim()) throw new Error("adapter name is required");
+  if (!input.version.trim()) throw new Error("adapter version is required");
+  if (!input.framework.trim()) throw new Error("adapter framework is required");
+  return { ...input };
+}
+function registerAdapter(registration) {
+  const normalized = createAdapterRegistration(registration);
+  registry.set(normalized.id, normalized);
+  return normalized;
+}
+function getRegisteredAdapter(id) {
+  return registry.get(id);
+}
+function listRegisteredAdapters() {
+  return [...registry.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+function clearAdapterRegistry() {
+  registry.clear();
+}
+
+// packages/adapter-sdk/src/mapping.ts
+function eventsToJsonl(events) {
+  return `${events.map((event) => JSON.stringify(event)).join("\n")}
+`;
+}
+function flattenInspectNodes(nodes) {
+  return nodes.flatMap((node) => [node, ...flattenInspectNodes(node.children)]);
+}
+function extractPersistedKinds(events) {
+  return events.map((event) => event.kind);
+}
+function stableStringify(value) {
+  return JSON.stringify(sortJson(value)) ?? "null";
+}
+function sortJson(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => sortJson(item));
+  }
+  if (isPlainRecord(value)) {
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+      sorted[key] = sortJson(value[key]);
+    }
+    return sorted;
+  }
+  return value === void 0 ? null : value;
+}
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// packages/adapter-sdk/src/fixtures.ts
+var DEFAULT_COVERS = [
+  "run",
+  "step",
+  "tool",
+  "llm",
+  "error",
+  "streaming",
+  "metadata-bounds"
+];
+function createAdapterFixtureSkeleton(adapterId) {
+  return {
+    adapterId,
+    captureDefault: "metadata-only",
+    network: "none",
+    suggestedCovers: [...DEFAULT_COVERS],
+    notes: [
+      "Use local mocks only; no provider API keys or network calls.",
+      "Persist metadata-only by default; opt into preview/full capture explicitly.",
+      "Include forbidden raw strings in conformance tests when prompts are mocked.",
+      "Run runAdapterConformance against captured PersistedInspectEvent arrays."
+    ]
+  };
+}
+function createConformanceFixtureMeta(adapterId) {
+  return {
+    adapterId,
+    defaults: {
+      network: "none",
+      upload: "none",
+      capture: "metadata-only"
+    },
+    skeleton: createAdapterFixtureSkeleton(adapterId)
+  };
+}
+
+// packages/adapter-sdk/src/privacy.ts
+var PRIVACY_CHECKLIST_ITEMS = [
+  {
+    id: "capture-metadata-only-default",
+    label: "Default capture is metadata-only (no full prompts/outputs on disk)",
+    required: true
+  },
+  {
+    id: "no-network-by-default",
+    label: "Adapter tests and defaults do not call external networks",
+    required: true
+  },
+  {
+    id: "no-upload",
+    label: "Adapter does not upload traces or logs to vendors by default",
+    required: true
+  },
+  {
+    id: "redaction-documented",
+    label: "Redaction/capture modes are documented for adapter users",
+    required: true
+  },
+  {
+    id: "framework-deps-scoped",
+    label: "Framework SDK dependencies stay in the optional adapter package",
+    required: true
+  }
+];
+function runPrivacyChecklist(input = {}) {
+  const captureMode = input.captureMode ?? "metadata-only";
+  const items = [
+    {
+      id: "capture-metadata-only-default",
+      ok: captureMode === "metadata-only",
+      detail: captureMode === "metadata-only" ? void 0 : `captureMode is ${captureMode}; metadata-only is required by default`
+    },
+    {
+      id: "no-network-by-default",
+      ok: input.networkAllowed !== true,
+      detail: input.networkAllowed ? "network must be disabled in adapter defaults" : void 0
+    },
+    {
+      id: "no-upload",
+      ok: input.uploadAllowed !== true,
+      detail: input.uploadAllowed ? "upload must not be enabled by default" : void 0
+    },
+    {
+      id: "redaction-documented",
+      ok: input.redactionDocumented !== false,
+      detail: input.redactionDocumented === false ? "document capture/redaction behavior in adapter README" : void 0
+    },
+    {
+      id: "framework-deps-scoped",
+      ok: input.frameworkDepsPackageScoped !== false,
+      detail: input.frameworkDepsPackageScoped === false ? "keep framework SDK deps out of agent-inspect root/core" : void 0
+    }
+  ];
+  const requiredFailed = items.some(
+    (item) => PRIVACY_CHECKLIST_ITEMS.find((def) => def.id === item.id)?.required && !item.ok
+  );
+  return { ok: !requiredFailed, items };
+}
+async function runAdapterConformance(options) {
+  const checks = [];
+  const { adapterId, events } = options;
+  checks.push({
+    id: "events-non-empty",
+    ok: events.length > 0,
+    detail: events.length > 0 ? void 0 : "expected at least one persisted event"
+  });
+  const schemaOk = events.every(
+    (event) => event.schemaVersion === "0.2" || event.schemaVersion === "1.0"
+  );
+  checks.push({
+    id: "schema-persisted",
+    ok: schemaOk,
+    detail: schemaOk ? void 0 : "all events must use schemaVersion 0.2 or 1.0"
+  });
+  if (options.forbiddenRawStrings && options.forbiddenRawStrings.length > 0) {
+    const serialized = JSON.stringify(events);
+    const leaks = options.forbiddenRawStrings.filter((raw) => serialized.includes(raw));
+    checks.push({
+      id: "no-forbidden-raw-strings",
+      ok: leaks.length === 0,
+      detail: leaks.length === 0 ? void 0 : `forbidden raw strings leaked: ${leaks.join(", ")}`
+    });
+  }
+  try {
+    const trees = persisted.persistedInspectEventsToRunTrees([...events]);
+    checks.push({
+      id: "run-tree-built",
+      ok: trees.length > 0,
+      detail: trees.length > 0 ? void 0 : "persistedInspectEventsToRunTrees returned no runs"
+    });
+    if (options.expectedKinds && options.expectedKinds.length > 0 && trees[0]) {
+      const kinds = flattenInspectNodes(trees[0].children).map((node) => node.event.kind);
+      const kindsOk = stableStringify(kinds) === stableStringify([...options.expectedKinds]);
+      checks.push({
+        id: "expected-kinds",
+        ok: kindsOk,
+        detail: kindsOk ? void 0 : `expected kinds ${options.expectedKinds.join(",")} but got ${kinds.join(",")}`
+      });
+    }
+    const normalized = persisted.persistedInspectEventsToTraceEvents([...events]);
+    checks.push({
+      id: "legacy-normalization",
+      ok: normalized.length > 0,
+      detail: normalized.length > 0 ? void 0 : "persistedInspectEventsToTraceEvents returned empty"
+    });
+    const input = { type: "string", content: eventsToJsonl(events) };
+    const read = await readers.readTrace(input, { format: "agent-inspect-jsonl" });
+    const opened = await readers.openTrace(input, { format: "agent-inspect-jsonl" });
+    const roundTripOk = stableStringify(read.runs) === stableStringify(opened.runs);
+    checks.push({
+      id: "reader-round-trip",
+      ok: roundTripOk,
+      detail: roundTripOk ? void 0 : "readTrace and openTrace runs differ"
+    });
+  } catch (error) {
+    checks.push({
+      id: "conformance-runtime",
+      ok: false,
+      detail: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return {
+    ok: checks.every((check) => check.ok),
+    adapterId,
+    checks
+  };
+}
+function findPairedLifecycle(events, kind, terminalStatus = "ok") {
+  const ofKind = events.filter((event) => event.kind === kind);
+  const started = ofKind.find((event) => event.status === "running");
+  const completed = ofKind.find(
+    (event) => event.status === terminalStatus || event.status === "error"
+  );
+  if (started !== void 0 || completed === void 0) {
+    return { started, completed };
+  }
+  const completedById = completed;
+  const startedById = ofKind.find(
+    (event) => event.eventId === completedById.eventId && event.status === "running"
+  );
+  return { started: startedById, completed: completedById };
+}
+
+exports.PRIVACY_CHECKLIST_ITEMS = PRIVACY_CHECKLIST_ITEMS;
+exports.clearAdapterRegistry = clearAdapterRegistry;
+exports.createAdapterFixtureSkeleton = createAdapterFixtureSkeleton;
+exports.createAdapterRegistration = createAdapterRegistration;
+exports.createConformanceFixtureMeta = createConformanceFixtureMeta;
+exports.eventsToJsonl = eventsToJsonl;
+exports.extractPersistedKinds = extractPersistedKinds;
+exports.findPairedLifecycle = findPairedLifecycle;
+exports.flattenInspectNodes = flattenInspectNodes;
+exports.getRegisteredAdapter = getRegisteredAdapter;
+exports.listRegisteredAdapters = listRegisteredAdapters;
+exports.registerAdapter = registerAdapter;
+exports.runAdapterConformance = runAdapterConformance;
+exports.runPrivacyChecklist = runPrivacyChecklist;
+exports.stableStringify = stableStringify;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registration.ts","../src/mapping.ts","../src/fixtures.ts","../src/privacy.ts","../src/conformance.ts"],"names":["persistedInspectEventsToRunTrees","persistedInspectEventsToTraceEvents","readTrace","openTrace"],"mappings":";;;;;;AAEA,IAAM,QAAA,uBAAe,GAAA,EAAiC;AAE/C,SAAS,0BACd,KAAA,EACqB;AACrB,EAAA,IAAI,CAAC,MAAM,EAAA,CAAG,IAAA,IAAQ,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAC9D,EAAA,IAAI,CAAC,MAAM,IAAA,CAAK,IAAA,IAAQ,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAClE,EAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,IAAA,IAAQ,MAAM,IAAI,MAAM,6BAA6B,CAAA;AACxE,EAAA,IAAI,CAAC,MAAM,SAAA,CAAU,IAAA,IAAQ,MAAM,IAAI,MAAM,+BAA+B,CAAA;AAC5E,EAAA,OAAO,EAAE,GAAG,KAAA,EAAM;AACpB;AAEO,SAAS,gBAAgB,YAAA,EAAwD;AACtF,EAAA,MAAM,UAAA,GAAa,0BAA0B,YAAY,CAAA;AACzD,EAAA,QAAA,CAAS,GAAA,CAAI,UAAA,CAAW,EAAA,EAAI,UAAU,CAAA;AACtC,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,qBAAqB,EAAA,EAA6C;AAChF,EAAA,OAAO,QAAA,CAAS,IAAI,EAAE,CAAA;AACxB;AAEO,SAAS,sBAAA,GAAyD;AACvE,EAAA,OAAO,CAAC,GAAG,QAAA,CAAS,MAAA,EAAQ,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,EAAA,CAAG,aAAA,CAAc,CAAA,CAAE,EAAE,CAAC,CAAA;AACvE;AAEO,SAAS,oBAAA,GAA6B;AAC3C,EAAA,QAAA,CAAS,KAAA,EAAM;AACjB;;;ACvBO,SAAS,cAAc,MAAA,EAAoC;AAChE,EAAA,OAAO,CAAA,EAAG,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAU,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC;AAAA,CAAA;AACnE;AAEO,SAAS,oBAAoB,KAAA,EAAsD;AACxF,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,KAAS,CAAC,IAAA,EAAM,GAAG,mBAAA,CAAoB,IAAA,CAAK,QAAQ,CAAC,CAAC,CAAA;AAC9E;AAEO,SAAS,sBACd,MAAA,EACiC;AACjC,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAU,MAAM,IAAI,CAAA;AACzC;AAEO,SAAS,gBAAgB,KAAA,EAAwB;AACtD,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,KAAK,CAAC,CAAA,IAAK,MAAA;AAC5C;AAEA,SAAS,SAAS,KAAA,EAAyB;AACzC,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,IAAA,OAAO,MAAM,GAAA,CAAI,CAAC,IAAA,KAAS,QAAA,CAAS,IAAI,CAAC,CAAA;AAAA,EAC3C;AACA,EAAA,IAAI,aAAA,CAAc,KAAK,CAAA,EAAG;AACxB,IAAA,MAAM,SAAkC,EAAC;AACzC,IAAA,KAAA,MAAW,OAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,MAAK,EAAG;AAC3C,MAAA,MAAA,CAAO,GAAG,CAAA,GAAI,QAAA,CAAS,KAAA,CAAM,GAAG,CAAC,CAAA;AAAA,IACnC;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA,KAAU,SAAY,IAAA,GAAO,KAAA;AACtC;AAEA,SAAS,cAAc,KAAA,EAAkD;AACvE,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;;;ACvCA,IAAM,cAAA,GAAiB;AAAA,EACrB,KAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAA;AAEO,SAAS,6BAA6B,SAAA,EAA2C;AACtF,EAAA,OAAO;AAAA,IACL,SAAA;AAAA,IACA,cAAA,EAAgB,eAAA;AAAA,IAChB,OAAA,EAAS,MAAA;AAAA,IACT,eAAA,EAAiB,CAAC,GAAG,cAAc,CAAA;AAAA,IACnC,KAAA,EAAO;AAAA,MACL,8DAAA;AAAA,MACA,6EAAA;AAAA,MACA,6EAAA;AAAA,MACA;AAAA;AACF,GACF;AACF;AAEO,SAAS,6BAA6B,SAAA,EAAmB;AAC9D,EAAA,OAAO;AAAA,IACL,SAAA;AAAA,IACA,QAAA,EAAU;AAAA,MACR,OAAA,EAAS,MAAA;AAAA,MACT,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,KACX;AAAA,IACA,QAAA,EAAU,6BAA6B,SAAS;AAAA,GAClD;AACF;;;AC9BO,IAAM,uBAAA,GAA2D;AAAA,EACtE;AAAA,IACE,EAAA,EAAI,+BAAA;AAAA,IACJ,KAAA,EAAO,oEAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA;AAAA,IACE,EAAA,EAAI,uBAAA;AAAA,IACJ,KAAA,EAAO,0DAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA;AAAA,IACE,EAAA,EAAI,WAAA;AAAA,IACJ,KAAA,EAAO,8DAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA;AAAA,IACE,EAAA,EAAI,sBAAA;AAAA,IACJ,KAAA,EAAO,0DAAA;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA;AAAA,IACE,EAAA,EAAI,uBAAA;AAAA,IACJ,KAAA,EAAO,iEAAA;AAAA,IACP,QAAA,EAAU;AAAA;AAEd;AAEO,SAAS,mBAAA,CAAoB,KAAA,GAA+B,EAAC,EAA2B;AAC7F,EAAA,MAAM,WAAA,GAAc,MAAM,WAAA,IAAe,eAAA;AACzC,EAAA,MAAM,KAAA,GAA4B;AAAA,IAChC;AAAA,MACE,EAAA,EAAI,+BAAA;AAAA,MACJ,IAAI,WAAA,KAAgB,eAAA;AAAA,MACpB,MAAA,EACE,WAAA,KAAgB,eAAA,GACZ,MAAA,GACA,kBAAkB,WAAW,CAAA,sCAAA;AAAA,KACrC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,uBAAA;AAAA,MACJ,EAAA,EAAI,MAAM,cAAA,KAAmB,IAAA;AAAA,MAC7B,MAAA,EAAQ,KAAA,CAAM,cAAA,GAAiB,8CAAA,GAAiD;AAAA,KAClF;AAAA,IACA;AAAA,MACE,EAAA,EAAI,WAAA;AAAA,MACJ,EAAA,EAAI,MAAM,aAAA,KAAkB,IAAA;AAAA,MAC5B,MAAA,EAAQ,KAAA,CAAM,aAAA,GAAgB,uCAAA,GAA0C;AAAA,KAC1E;AAAA,IACA;AAAA,MACE,EAAA,EAAI,sBAAA;AAAA,MACJ,EAAA,EAAI,MAAM,mBAAA,KAAwB,KAAA;AAAA,MAClC,MAAA,EACE,KAAA,CAAM,mBAAA,KAAwB,KAAA,GAC1B,uDAAA,GACA;AAAA,KACR;AAAA,IACA;AAAA,MACE,EAAA,EAAI,uBAAA;AAAA,MACJ,EAAA,EAAI,MAAM,0BAAA,KAA+B,KAAA;AAAA,MACzC,MAAA,EACE,KAAA,CAAM,0BAAA,KAA+B,KAAA,GACjC,wDAAA,GACA;AAAA;AACR,GACF;AAEA,EAAA,MAAM,iBAAiB,KAAA,CAAM,IAAA;AAAA,IAC3B,CAAC,IAAA,KACC,uBAAA,CAAwB,IAAA,CAAK,CAAC,GAAA,KAAQ,GAAA,CAAI,EAAA,KAAO,IAAA,CAAK,EAAE,CAAA,EAAG,QAAA,IAAY,CAAC,IAAA,CAAK;AAAA,GACjF;AAEA,EAAA,OAAO,EAAE,EAAA,EAAI,CAAC,cAAA,EAAgB,KAAA,EAAM;AACtC;AClEA,eAAsB,sBACpB,OAAA,EACmC;AACnC,EAAA,MAAM,SAA6B,EAAC;AACpC,EAAA,MAAM,EAAE,SAAA,EAAW,MAAA,EAAO,GAAI,OAAA;AAE9B,EAAA,MAAA,CAAO,IAAA,CAAK;AAAA,IACV,EAAA,EAAI,kBAAA;AAAA,IACJ,EAAA,EAAI,OAAO,MAAA,GAAS,CAAA;AAAA,IACpB,MAAA,EAAQ,MAAA,CAAO,MAAA,GAAS,CAAA,GAAI,MAAA,GAAY;AAAA,GACzC,CAAA;AAED,EAAA,MAAM,WAAW,MAAA,CAAO,KAAA;AAAA,IACtB,CAAC,KAAA,KAAU,KAAA,CAAM,aAAA,KAAkB,KAAA,IAAS,MAAM,aAAA,KAAkB;AAAA,GACtE;AACA,EAAA,MAAA,CAAO,IAAA,CAAK;AAAA,IACV,EAAA,EAAI,kBAAA;AAAA,IACJ,EAAA,EAAI,QAAA;AAAA,IACJ,MAAA,EAAQ,WAAW,MAAA,GAAY;AAAA,GAChC,CAAA;AAED,EAAA,IAAI,OAAA,CAAQ,mBAAA,IAAuB,OAAA,CAAQ,mBAAA,CAAoB,SAAS,CAAA,EAAG;AACzE,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AACxC,IAAA,MAAM,KAAA,GAAQ,QAAQ,mBAAA,CAAoB,MAAA,CAAO,CAAC,GAAA,KAAQ,UAAA,CAAW,QAAA,CAAS,GAAG,CAAC,CAAA;AAClF,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,0BAAA;AAAA,MACJ,EAAA,EAAI,MAAM,MAAA,KAAW,CAAA;AAAA,MACrB,MAAA,EACE,MAAM,MAAA,KAAW,CAAA,GAAI,SAAY,CAAA,8BAAA,EAAiC,KAAA,CAAM,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACrF,CAAA;AAAA,EACH;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQA,0CAAA,CAAiC,CAAC,GAAG,MAAM,CAAC,CAAA;AAC1D,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,gBAAA;AAAA,MACJ,EAAA,EAAI,MAAM,MAAA,GAAS,CAAA;AAAA,MACnB,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,CAAA,GAAI,KAAA,CAAA,GAAY;AAAA,KACxC,CAAA;AAED,IAAA,IAAI,OAAA,CAAQ,iBAAiB,OAAA,CAAQ,aAAA,CAAc,SAAS,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,EAAG;AACzE,MAAA,MAAM,KAAA,GAAQ,mBAAA,CAAoB,KAAA,CAAM,CAAC,CAAA,CAAE,QAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAClF,MAAA,MAAM,OAAA,GAAU,gBAAgB,KAAK,CAAA,KAAM,gBAAgB,CAAC,GAAG,OAAA,CAAQ,aAAa,CAAC,CAAA;AACrF,MAAA,MAAA,CAAO,IAAA,CAAK;AAAA,QACV,EAAA,EAAI,gBAAA;AAAA,QACJ,EAAA,EAAI,OAAA;AAAA,QACJ,MAAA,EAAQ,OAAA,GACJ,KAAA,CAAA,GACA,CAAA,eAAA,EAAkB,OAAA,CAAQ,aAAA,CAAc,IAAA,CAAK,GAAG,CAAC,CAAA,SAAA,EAAY,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,CAAA;AAAA,OACjF,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,UAAA,GAAaC,6CAAA,CAAoC,CAAC,GAAG,MAAM,CAAC,CAAA;AAClE,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,sBAAA;AAAA,MACJ,EAAA,EAAI,WAAW,MAAA,GAAS,CAAA;AAAA,MACxB,MAAA,EACE,UAAA,CAAW,MAAA,GAAS,CAAA,GAAI,KAAA,CAAA,GAAY;AAAA,KACvC,CAAA;AAED,IAAA,MAAM,QAAQ,EAAE,IAAA,EAAM,UAAmB,OAAA,EAAS,aAAA,CAAc,MAAM,CAAA,EAAE;AACxE,IAAA,MAAM,OAAO,MAAMC,iBAAA,CAAU,OAAO,EAAE,MAAA,EAAQ,uBAAuB,CAAA;AACrE,IAAA,MAAM,SAAS,MAAMC,iBAAA,CAAU,OAAO,EAAE,MAAA,EAAQ,uBAAuB,CAAA;AACvE,IAAA,MAAM,cAAc,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,KAAM,eAAA,CAAgB,OAAO,IAAI,CAAA;AAC9E,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,mBAAA;AAAA,MACJ,EAAA,EAAI,WAAA;AAAA,MACJ,MAAA,EAAQ,cAAc,KAAA,CAAA,GAAY;AAAA,KACnC,CAAA;AAAA,EACH,SAAS,KAAA,EAAO;AACd,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA,MACV,EAAA,EAAI,qBAAA;AAAA,MACJ,EAAA,EAAI,KAAA;AAAA,MACJ,QAAQ,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK;AAAA,KAC9D,CAAA;AAAA,EACH;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,MAAA,CAAO,KAAA,CAAM,CAAC,KAAA,KAAU,MAAM,EAAE,CAAA;AAAA,IACpC,SAAA;AAAA,IACA;AAAA,GACF;AACF;AAEO,SAAS,mBAAA,CACd,MAAA,EACA,IAAA,EACA,cAAA,GAAiC,IAAA,EACuC;AACxE,EAAA,MAAM,SAAS,MAAA,CAAO,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,SAAS,IAAI,CAAA;AAC3D,EAAA,MAAM,UAAU,MAAA,CAAO,IAAA,CAAK,CAAC,KAAA,KAAU,KAAA,CAAM,WAAW,SAAS,CAAA;AACjE,EAAA,MAAM,YAAY,MAAA,CAAO,IAAA;AAAA,IACvB,CAAC,KAAA,KAAU,KAAA,CAAM,MAAA,KAAW,cAAA,IAAkB,MAAM,MAAA,KAAW;AAAA,GACjE;AACA,EAAA,IAAI,OAAA,KAAY,MAAA,IAAa,SAAA,KAAc,MAAA,EAAW;AACpD,IAAA,OAAO,EAAE,SAAS,SAAA,EAAU;AAAA,EAC9B;AACA,EAAA,MAAM,aAAA,GAAgB,SAAA;AACtB,EAAA,MAAM,cAAc,MAAA,CAAO,IAAA;AAAA,IACzB,CAAC,KAAA,KAAU,KAAA,CAAM,YAAY,aAAA,CAAc,OAAA,IAAW,MAAM,MAAA,KAAW;AAAA,GACzE;AACA,EAAA,OAAO,EAAE,OAAA,EAAS,WAAA,EAAa,SAAA,EAAW,aAAA,EAAc;AAC1D","file":"index.cjs","sourcesContent":["import type { AdapterRegistration } from \"./types.js\";\n\nconst registry = new Map<string, AdapterRegistration>();\n\nexport function createAdapterRegistration(\n  input: AdapterRegistration,\n): AdapterRegistration {\n  if (!input.id.trim()) throw new Error(\"adapter id is required\");\n  if (!input.name.trim()) throw new Error(\"adapter name is required\");\n  if (!input.version.trim()) throw new Error(\"adapter version is required\");\n  if (!input.framework.trim()) throw new Error(\"adapter framework is required\");\n  return { ...input };\n}\n\nexport function registerAdapter(registration: AdapterRegistration): AdapterRegistration {\n  const normalized = createAdapterRegistration(registration);\n  registry.set(normalized.id, normalized);\n  return normalized;\n}\n\nexport function getRegisteredAdapter(id: string): AdapterRegistration | undefined {\n  return registry.get(id);\n}\n\nexport function listRegisteredAdapters(): readonly AdapterRegistration[] {\n  return [...registry.values()].sort((a, b) => a.id.localeCompare(b.id));\n}\n\nexport function clearAdapterRegistry(): void {\n  registry.clear();\n}\n","import type { PersistedInspectEvent } from \"agent-inspect/persisted\";\n\nexport interface InspectNodeLike {\n  event: { kind: string };\n  children: InspectNodeLike[];\n}\n\nexport function eventsToJsonl(events: readonly unknown[]): string {\n  return `${events.map((event) => JSON.stringify(event)).join(\"\\n\")}\\n`;\n}\n\nexport function flattenInspectNodes(nodes: readonly InspectNodeLike[]): InspectNodeLike[] {\n  return nodes.flatMap((node) => [node, ...flattenInspectNodes(node.children)]);\n}\n\nexport function extractPersistedKinds(\n  events: readonly PersistedInspectEvent[],\n): PersistedInspectEvent[\"kind\"][] {\n  return events.map((event) => event.kind);\n}\n\nexport function stableStringify(value: unknown): string {\n  return JSON.stringify(sortJson(value)) ?? \"null\";\n}\n\nfunction sortJson(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => sortJson(item));\n  }\n  if (isPlainRecord(value)) {\n    const sorted: Record<string, unknown> = {};\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = sortJson(value[key]);\n    }\n    return sorted;\n  }\n  return value === undefined ? null : value;\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import type { AdapterFixtureSkeleton } from \"./types.js\";\n\nconst DEFAULT_COVERS = [\n  \"run\",\n  \"step\",\n  \"tool\",\n  \"llm\",\n  \"error\",\n  \"streaming\",\n  \"metadata-bounds\",\n] as const;\n\nexport function createAdapterFixtureSkeleton(adapterId: string): AdapterFixtureSkeleton {\n  return {\n    adapterId,\n    captureDefault: \"metadata-only\",\n    network: \"none\",\n    suggestedCovers: [...DEFAULT_COVERS],\n    notes: [\n      \"Use local mocks only; no provider API keys or network calls.\",\n      \"Persist metadata-only by default; opt into preview/full capture explicitly.\",\n      \"Include forbidden raw strings in conformance tests when prompts are mocked.\",\n      \"Run runAdapterConformance against captured PersistedInspectEvent arrays.\",\n    ],\n  };\n}\n\nexport function createConformanceFixtureMeta(adapterId: string) {\n  return {\n    adapterId,\n    defaults: {\n      network: \"none\",\n      upload: \"none\",\n      capture: \"metadata-only\",\n    },\n    skeleton: createAdapterFixtureSkeleton(adapterId),\n  };\n}\n","import type {\n  ConformanceCheck,\n  PrivacyChecklistInput,\n  PrivacyChecklistItem,\n  PrivacyChecklistResult,\n} from \"./types.js\";\n\nexport const PRIVACY_CHECKLIST_ITEMS: readonly PrivacyChecklistItem[] = [\n  {\n    id: \"capture-metadata-only-default\",\n    label: \"Default capture is metadata-only (no full prompts/outputs on disk)\",\n    required: true,\n  },\n  {\n    id: \"no-network-by-default\",\n    label: \"Adapter tests and defaults do not call external networks\",\n    required: true,\n  },\n  {\n    id: \"no-upload\",\n    label: \"Adapter does not upload traces or logs to vendors by default\",\n    required: true,\n  },\n  {\n    id: \"redaction-documented\",\n    label: \"Redaction/capture modes are documented for adapter users\",\n    required: true,\n  },\n  {\n    id: \"framework-deps-scoped\",\n    label: \"Framework SDK dependencies stay in the optional adapter package\",\n    required: true,\n  },\n] as const;\n\nexport function runPrivacyChecklist(input: PrivacyChecklistInput = {}): PrivacyChecklistResult {\n  const captureMode = input.captureMode ?? \"metadata-only\";\n  const items: ConformanceCheck[] = [\n    {\n      id: \"capture-metadata-only-default\",\n      ok: captureMode === \"metadata-only\",\n      detail:\n        captureMode === \"metadata-only\"\n          ? undefined\n          : `captureMode is ${captureMode}; metadata-only is required by default`,\n    },\n    {\n      id: \"no-network-by-default\",\n      ok: input.networkAllowed !== true,\n      detail: input.networkAllowed ? \"network must be disabled in adapter defaults\" : undefined,\n    },\n    {\n      id: \"no-upload\",\n      ok: input.uploadAllowed !== true,\n      detail: input.uploadAllowed ? \"upload must not be enabled by default\" : undefined,\n    },\n    {\n      id: \"redaction-documented\",\n      ok: input.redactionDocumented !== false,\n      detail:\n        input.redactionDocumented === false\n          ? \"document capture/redaction behavior in adapter README\"\n          : undefined,\n    },\n    {\n      id: \"framework-deps-scoped\",\n      ok: input.frameworkDepsPackageScoped !== false,\n      detail:\n        input.frameworkDepsPackageScoped === false\n          ? \"keep framework SDK deps out of agent-inspect root/core\"\n          : undefined,\n    },\n  ];\n\n  const requiredFailed = items.some(\n    (item) =>\n      PRIVACY_CHECKLIST_ITEMS.find((def) => def.id === item.id)?.required && !item.ok,\n  );\n\n  return { ok: !requiredFailed, items };\n}\n","import {\n  persistedInspectEventsToRunTrees,\n  persistedInspectEventsToTraceEvents,\n  type PersistedInspectEvent,\n} from \"agent-inspect/persisted\";\nimport { openTrace, readTrace } from \"agent-inspect/readers\";\n\nimport { eventsToJsonl, flattenInspectNodes, stableStringify } from \"./mapping.js\";\nimport type {\n  AdapterConformanceOptions,\n  AdapterConformanceResult,\n  ConformanceCheck,\n} from \"./types.js\";\n\nexport async function runAdapterConformance(\n  options: AdapterConformanceOptions,\n): Promise<AdapterConformanceResult> {\n  const checks: ConformanceCheck[] = [];\n  const { adapterId, events } = options;\n\n  checks.push({\n    id: \"events-non-empty\",\n    ok: events.length > 0,\n    detail: events.length > 0 ? undefined : \"expected at least one persisted event\",\n  });\n\n  const schemaOk = events.every(\n    (event) => event.schemaVersion === \"0.2\" || event.schemaVersion === \"1.0\",\n  );\n  checks.push({\n    id: \"schema-persisted\",\n    ok: schemaOk,\n    detail: schemaOk ? undefined : \"all events must use schemaVersion 0.2 or 1.0\",\n  });\n\n  if (options.forbiddenRawStrings && options.forbiddenRawStrings.length > 0) {\n    const serialized = JSON.stringify(events);\n    const leaks = options.forbiddenRawStrings.filter((raw) => serialized.includes(raw));\n    checks.push({\n      id: \"no-forbidden-raw-strings\",\n      ok: leaks.length === 0,\n      detail:\n        leaks.length === 0 ? undefined : `forbidden raw strings leaked: ${leaks.join(\", \")}`,\n    });\n  }\n\n  try {\n    const trees = persistedInspectEventsToRunTrees([...events]);\n    checks.push({\n      id: \"run-tree-built\",\n      ok: trees.length > 0,\n      detail: trees.length > 0 ? undefined : \"persistedInspectEventsToRunTrees returned no runs\",\n    });\n\n    if (options.expectedKinds && options.expectedKinds.length > 0 && trees[0]) {\n      const kinds = flattenInspectNodes(trees[0].children).map((node) => node.event.kind);\n      const kindsOk = stableStringify(kinds) === stableStringify([...options.expectedKinds]);\n      checks.push({\n        id: \"expected-kinds\",\n        ok: kindsOk,\n        detail: kindsOk\n          ? undefined\n          : `expected kinds ${options.expectedKinds.join(\",\")} but got ${kinds.join(\",\")}`,\n      });\n    }\n\n    const normalized = persistedInspectEventsToTraceEvents([...events]);\n    checks.push({\n      id: \"legacy-normalization\",\n      ok: normalized.length > 0,\n      detail:\n        normalized.length > 0 ? undefined : \"persistedInspectEventsToTraceEvents returned empty\",\n    });\n\n    const input = { type: \"string\" as const, content: eventsToJsonl(events) };\n    const read = await readTrace(input, { format: \"agent-inspect-jsonl\" });\n    const opened = await openTrace(input, { format: \"agent-inspect-jsonl\" });\n    const roundTripOk = stableStringify(read.runs) === stableStringify(opened.runs);\n    checks.push({\n      id: \"reader-round-trip\",\n      ok: roundTripOk,\n      detail: roundTripOk ? undefined : \"readTrace and openTrace runs differ\",\n    });\n  } catch (error) {\n    checks.push({\n      id: \"conformance-runtime\",\n      ok: false,\n      detail: error instanceof Error ? error.message : String(error),\n    });\n  }\n\n  return {\n    ok: checks.every((check) => check.ok),\n    adapterId,\n    checks,\n  };\n}\n\nexport function findPairedLifecycle(\n  events: readonly PersistedInspectEvent[],\n  kind: PersistedInspectEvent[\"kind\"],\n  terminalStatus: \"ok\" | \"error\" = \"ok\",\n): { started?: PersistedInspectEvent; completed?: PersistedInspectEvent } {\n  const ofKind = events.filter((event) => event.kind === kind);\n  const started = ofKind.find((event) => event.status === \"running\");\n  const completed = ofKind.find(\n    (event) => event.status === terminalStatus || event.status === \"error\",\n  );\n  if (started !== undefined || completed === undefined) {\n    return { started, completed };\n  }\n  const completedById = completed;\n  const startedById = ofKind.find(\n    (event) => event.eventId === completedById.eventId && event.status === \"running\",\n  );\n  return { started: startedById, completed: completedById };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,90 @@
+import { PersistedInspectEvent } from 'agent-inspect/persisted';
+
+interface AdapterRegistration {
+    id: string;
+    name: string;
+    version: string;
+    framework: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ConformanceCheck {
+    id: string;
+    ok: boolean;
+    detail?: string;
+}
+interface AdapterConformanceOptions {
+    adapterId: string;
+    events: readonly PersistedInspectEvent[];
+    /** Strings that must not appear in serialized persisted output. */
+    forbiddenRawStrings?: readonly string[];
+    /** Expected step kinds in tree order (excluding RUN root handling). */
+    expectedKinds?: readonly PersistedInspectEvent["kind"][];
+}
+interface AdapterConformanceResult {
+    ok: boolean;
+    adapterId: string;
+    checks: ConformanceCheck[];
+}
+interface PrivacyChecklistItem {
+    id: string;
+    label: string;
+    required: boolean;
+}
+interface PrivacyChecklistInput {
+    captureMode?: "metadata-only" | "preview" | "full";
+    networkAllowed?: boolean;
+    uploadAllowed?: boolean;
+    redactionDocumented?: boolean;
+    frameworkDepsPackageScoped?: boolean;
+}
+interface PrivacyChecklistResult {
+    ok: boolean;
+    items: ConformanceCheck[];
+}
+interface AdapterFixtureSkeleton {
+    adapterId: string;
+    captureDefault: "metadata-only";
+    network: "none";
+    suggestedCovers: string[];
+    notes: string[];
+}
+
+declare function createAdapterRegistration(input: AdapterRegistration): AdapterRegistration;
+declare function registerAdapter(registration: AdapterRegistration): AdapterRegistration;
+declare function getRegisteredAdapter(id: string): AdapterRegistration | undefined;
+declare function listRegisteredAdapters(): readonly AdapterRegistration[];
+declare function clearAdapterRegistry(): void;
+
+interface InspectNodeLike {
+    event: {
+        kind: string;
+    };
+    children: InspectNodeLike[];
+}
+declare function eventsToJsonl(events: readonly unknown[]): string;
+declare function flattenInspectNodes(nodes: readonly InspectNodeLike[]): InspectNodeLike[];
+declare function extractPersistedKinds(events: readonly PersistedInspectEvent[]): PersistedInspectEvent["kind"][];
+declare function stableStringify(value: unknown): string;
+
+declare function createAdapterFixtureSkeleton(adapterId: string): AdapterFixtureSkeleton;
+declare function createConformanceFixtureMeta(adapterId: string): {
+    adapterId: string;
+    defaults: {
+        network: string;
+        upload: string;
+        capture: string;
+    };
+    skeleton: AdapterFixtureSkeleton;
+};
+
+declare const PRIVACY_CHECKLIST_ITEMS: readonly PrivacyChecklistItem[];
+declare function runPrivacyChecklist(input?: PrivacyChecklistInput): PrivacyChecklistResult;
+
+declare function runAdapterConformance(options: AdapterConformanceOptions): Promise<AdapterConformanceResult>;
+declare function findPairedLifecycle(events: readonly PersistedInspectEvent[], kind: PersistedInspectEvent["kind"], terminalStatus?: "ok" | "error"): {
+    started?: PersistedInspectEvent;
+    completed?: PersistedInspectEvent;
+};
+
+export { type AdapterConformanceOptions, type AdapterConformanceResult, type AdapterFixtureSkeleton, type AdapterRegistration, type ConformanceCheck, PRIVACY_CHECKLIST_ITEMS, type PrivacyChecklistInput, type PrivacyChecklistItem, type PrivacyChecklistResult, clearAdapterRegistry, createAdapterFixtureSkeleton, createAdapterRegistration, createConformanceFixtureMeta, eventsToJsonl, extractPersistedKinds, findPairedLifecycle, flattenInspectNodes, getRegisteredAdapter, listRegisteredAdapters, registerAdapter, runAdapterConformance, runPrivacyChecklist, stableStringify };

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+import { PersistedInspectEvent } from 'agent-inspect/persisted';
+
+interface AdapterRegistration {
+    id: string;
+    name: string;
+    version: string;
+    framework: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ConformanceCheck {
+    id: string;
+    ok: boolean;
+    detail?: string;
+}
+interface AdapterConformanceOptions {
+    adapterId: string;
+    events: readonly PersistedInspectEvent[];
+    /** Strings that must not appear in serialized persisted output. */
+    forbiddenRawStrings?: readonly string[];
+    /** Expected step kinds in tree order (excluding RUN root handling). */
+    expectedKinds?: readonly PersistedInspectEvent["kind"][];
+}
+interface AdapterConformanceResult {
+    ok: boolean;
+    adapterId: string;
+    checks: ConformanceCheck[];
+}
+interface PrivacyChecklistItem {
+    id: string;
+    label: string;
+    required: boolean;
+}
+interface PrivacyChecklistInput {
+    captureMode?: "metadata-only" | "preview" | "full";
+    networkAllowed?: boolean;
+    uploadAllowed?: boolean;
+    redactionDocumented?: boolean;
+    frameworkDepsPackageScoped?: boolean;
+}
+interface PrivacyChecklistResult {
+    ok: boolean;
+    items: ConformanceCheck[];
+}
+interface AdapterFixtureSkeleton {
+    adapterId: string;
+    captureDefault: "metadata-only";
+    network: "none";
+    suggestedCovers: string[];
+    notes: string[];
+}
+
+declare function createAdapterRegistration(input: AdapterRegistration): AdapterRegistration;
+declare function registerAdapter(registration: AdapterRegistration): AdapterRegistration;
+declare function getRegisteredAdapter(id: string): AdapterRegistration | undefined;
+declare function listRegisteredAdapters(): readonly AdapterRegistration[];
+declare function clearAdapterRegistry(): void;
+
+interface InspectNodeLike {
+    event: {
+        kind: string;
+    };
+    children: InspectNodeLike[];
+}
+declare function eventsToJsonl(events: readonly unknown[]): string;
+declare function flattenInspectNodes(nodes: readonly InspectNodeLike[]): InspectNodeLike[];
+declare function extractPersistedKinds(events: readonly PersistedInspectEvent[]): PersistedInspectEvent["kind"][];
+declare function stableStringify(value: unknown): string;
+
+declare function createAdapterFixtureSkeleton(adapterId: string): AdapterFixtureSkeleton;
+declare function createConformanceFixtureMeta(adapterId: string): {
+    adapterId: string;
+    defaults: {
+        network: string;
+        upload: string;
+        capture: string;
+    };
+    skeleton: AdapterFixtureSkeleton;
+};
+
+declare const PRIVACY_CHECKLIST_ITEMS: readonly PrivacyChecklistItem[];
+declare function runPrivacyChecklist(input?: PrivacyChecklistInput): PrivacyChecklistResult;
+
+declare function runAdapterConformance(options: AdapterConformanceOptions): Promise<AdapterConformanceResult>;
+declare function findPairedLifecycle(events: readonly PersistedInspectEvent[], kind: PersistedInspectEvent["kind"], terminalStatus?: "ok" | "error"): {
+    started?: PersistedInspectEvent;
+    completed?: PersistedInspectEvent;
+};
+
+export { type AdapterConformanceOptions, type AdapterConformanceResult, type AdapterFixtureSkeleton, type AdapterRegistration, type ConformanceCheck, PRIVACY_CHECKLIST_ITEMS, type PrivacyChecklistInput, type PrivacyChecklistItem, type PrivacyChecklistResult, clearAdapterRegistry, createAdapterFixtureSkeleton, createAdapterRegistration, createConformanceFixtureMeta, eventsToJsonl, extractPersistedKinds, findPairedLifecycle, flattenInspectNodes, getRegisteredAdapter, listRegisteredAdapters, registerAdapter, runAdapterConformance, runPrivacyChecklist, stableStringify };

package/dist/index.mjs

@@ -0,0 +1,244 @@
+import { persistedInspectEventsToRunTrees, persistedInspectEventsToTraceEvents } from 'agent-inspect/persisted';
+import { readTrace, openTrace } from 'agent-inspect/readers';
+
+// packages/adapter-sdk/src/registration.ts
+var registry = /* @__PURE__ */ new Map();
+function createAdapterRegistration(input) {
+  if (!input.id.trim()) throw new Error("adapter id is required");
+  if (!input.name.trim()) throw new Error("adapter name is required");
+  if (!input.version.trim()) throw new Error("adapter version is required");
+  if (!input.framework.trim()) throw new Error("adapter framework is required");
+  return { ...input };
+}
+function registerAdapter(registration) {
+  const normalized = createAdapterRegistration(registration);
+  registry.set(normalized.id, normalized);
+  return normalized;
+}
+function getRegisteredAdapter(id) {
+  return registry.get(id);
+}
+function listRegisteredAdapters() {
+  return [...registry.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+function clearAdapterRegistry() {
+  registry.clear();
+}
+
+// packages/adapter-sdk/src/mapping.ts
+function eventsToJsonl(events) {
+  return `${events.map((event) => JSON.stringify(event)).join("\n")}
+`;
+}
+function flattenInspectNodes(nodes) {
+  return nodes.flatMap((node) => [node, ...flattenInspectNodes(node.children)]);
+}
+function extractPersistedKinds(events) {
+  return events.map((event) => event.kind);
+}
+function stableStringify(value) {
+  return JSON.stringify(sortJson(value)) ?? "null";
+}
+function sortJson(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => sortJson(item));
+  }
+  if (isPlainRecord(value)) {
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+      sorted[key] = sortJson(value[key]);
+    }
+    return sorted;
+  }
+  return value === void 0 ? null : value;
+}
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// packages/adapter-sdk/src/fixtures.ts
+var DEFAULT_COVERS = [
+  "run",
+  "step",
+  "tool",
+  "llm",
+  "error",
+  "streaming",
+  "metadata-bounds"
+];
+function createAdapterFixtureSkeleton(adapterId) {
+  return {
+    adapterId,
+    captureDefault: "metadata-only",
+    network: "none",
+    suggestedCovers: [...DEFAULT_COVERS],
+    notes: [
+      "Use local mocks only; no provider API keys or network calls.",
+      "Persist metadata-only by default; opt into preview/full capture explicitly.",
+      "Include forbidden raw strings in conformance tests when prompts are mocked.",
+      "Run runAdapterConformance against captured PersistedInspectEvent arrays."
+    ]
+  };
+}
+function createConformanceFixtureMeta(adapterId) {
+  return {
+    adapterId,
+    defaults: {
+      network: "none",
+      upload: "none",
+      capture: "metadata-only"
+    },
+    skeleton: createAdapterFixtureSkeleton(adapterId)
+  };
+}
+
+// packages/adapter-sdk/src/privacy.ts
+var PRIVACY_CHECKLIST_ITEMS = [
+  {
+    id: "capture-metadata-only-default",
+    label: "Default capture is metadata-only (no full prompts/outputs on disk)",
+    required: true
+  },
+  {
+    id: "no-network-by-default",
+    label: "Adapter tests and defaults do not call external networks",
+    required: true
+  },
+  {
+    id: "no-upload",
+    label: "Adapter does not upload traces or logs to vendors by default",
+    required: true
+  },
+  {
+    id: "redaction-documented",
+    label: "Redaction/capture modes are documented for adapter users",
+    required: true
+  },
+  {
+    id: "framework-deps-scoped",
+    label: "Framework SDK dependencies stay in the optional adapter package",
+    required: true
+  }
+];
+function runPrivacyChecklist(input = {}) {
+  const captureMode = input.captureMode ?? "metadata-only";
+  const items = [
+    {
+      id: "capture-metadata-only-default",
+      ok: captureMode === "metadata-only",
+      detail: captureMode === "metadata-only" ? void 0 : `captureMode is ${captureMode}; metadata-only is required by default`
+    },
+    {
+      id: "no-network-by-default",
+      ok: input.networkAllowed !== true,
+      detail: input.networkAllowed ? "network must be disabled in adapter defaults" : void 0
+    },
+    {
+      id: "no-upload",
+      ok: input.uploadAllowed !== true,
+      detail: input.uploadAllowed ? "upload must not be enabled by default" : void 0
+    },
+    {
+      id: "redaction-documented",
+      ok: input.redactionDocumented !== false,
+      detail: input.redactionDocumented === false ? "document capture/redaction behavior in adapter README" : void 0
+    },
+    {
+      id: "framework-deps-scoped",
+      ok: input.frameworkDepsPackageScoped !== false,
+      detail: input.frameworkDepsPackageScoped === false ? "keep framework SDK deps out of agent-inspect root/core" : void 0
+    }
+  ];
+  const requiredFailed = items.some(
+    (item) => PRIVACY_CHECKLIST_ITEMS.find((def) => def.id === item.id)?.required && !item.ok
+  );
+  return { ok: !requiredFailed, items };
+}
+async function runAdapterConformance(options) {
+  const checks = [];
+  const { adapterId, events } = options;
+  checks.push({
+    id: "events-non-empty",
+    ok: events.length > 0,
+    detail: events.length > 0 ? void 0 : "expected at least one persisted event"
+  });
+  const schemaOk = events.every(
+    (event) => event.schemaVersion === "0.2" || event.schemaVersion === "1.0"
+  );
+  checks.push({
+    id: "schema-persisted",
+    ok: schemaOk,
+    detail: schemaOk ? void 0 : "all events must use schemaVersion 0.2 or 1.0"
+  });
+  if (options.forbiddenRawStrings && options.forbiddenRawStrings.length > 0) {
+    const serialized = JSON.stringify(events);
+    const leaks = options.forbiddenRawStrings.filter((raw) => serialized.includes(raw));
+    checks.push({
+      id: "no-forbidden-raw-strings",
+      ok: leaks.length === 0,
+      detail: leaks.length === 0 ? void 0 : `forbidden raw strings leaked: ${leaks.join(", ")}`
+    });
+  }
+  try {
+    const trees = persistedInspectEventsToRunTrees([...events]);
+    checks.push({
+      id: "run-tree-built",
+      ok: trees.length > 0,
+      detail: trees.length > 0 ? void 0 : "persistedInspectEventsToRunTrees returned no runs"
+    });
+    if (options.expectedKinds && options.expectedKinds.length > 0 && trees[0]) {
+      const kinds = flattenInspectNodes(trees[0].children).map((node) => node.event.kind);
+      const kindsOk = stableStringify(kinds) === stableStringify([...options.expectedKinds]);
+      checks.push({
+        id: "expected-kinds",
+        ok: kindsOk,
+        detail: kindsOk ? void 0 : `expected kinds ${options.expectedKinds.join(",")} but got ${kinds.join(",")}`
+      });
+    }
+    const normalized = persistedInspectEventsToTraceEvents([...events]);
+    checks.push({
+      id: "legacy-normalization",
+      ok: normalized.length > 0,
+      detail: normalized.length > 0 ? void 0 : "persistedInspectEventsToTraceEvents returned empty"
+    });
+    const input = { type: "string", content: eventsToJsonl(events) };
+    const read = await readTrace(input, { format: "agent-inspect-jsonl" });
+    const opened = await openTrace(input, { format: "agent-inspect-jsonl" });
+    const roundTripOk = stableStringify(read.runs) === stableStringify(opened.runs);
+    checks.push({
+      id: "reader-round-trip",
+      ok: roundTripOk,
+      detail: roundTripOk ? void 0 : "readTrace and openTrace runs differ"
+    });
+  } catch (error) {
+    checks.push({
+      id: "conformance-runtime",
+      ok: false,
+      detail: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return {
+    ok: checks.every((check) => check.ok),
+    adapterId,
+    checks
+  };
+}
+function findPairedLifecycle(events, kind, terminalStatus = "ok") {
+  const ofKind = events.filter((event) => event.kind === kind);
+  const started = ofKind.find((event) => event.status === "running");
+  const completed = ofKind.find(
+    (event) => event.status === terminalStatus || event.status === "error"
+  );
+  if (started !== void 0 || completed === void 0) {
+    return { started, completed };
+  }
+  const completedById = completed;
+  const startedById = ofKind.find(
+    (event) => event.eventId === completedById.eventId && event.status === "running"
+  );
+  return { started: startedById, completed: completedById };
+}
+
+export { PRIVACY_CHECKLIST_ITEMS, clearAdapterRegistry, createAdapterFixtureSkeleton, createAdapterRegistration, createConformanceFixtureMeta, eventsToJsonl, extractPersistedKinds, findPairedLifecycle, flattenInspectNodes, getRegisteredAdapter, listRegisteredAdapters, registerAdapter, runAdapterConformance, runPrivacyChecklist, stableStringify };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registration.ts","../src/mapping.ts","../src/fixtures.ts","../src/privacy.ts","../src/conformance.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AdapterRegistration } from \"./types.js\";\n\nconst registry = new Map<string, AdapterRegistration>();\n\nexport function createAdapterRegistration(\n  input: AdapterRegistration,\n): AdapterRegistration {\n  if (!input.id.trim()) throw new Error(\"adapter id is required\");\n  if (!input.name.trim()) throw new Error(\"adapter name is required\");\n  if (!input.version.trim()) throw new Error(\"adapter version is required\");\n  if (!input.framework.trim()) throw new Error(\"adapter framework is required\");\n  return { ...input };\n}\n\nexport function registerAdapter(registration: AdapterRegistration): AdapterRegistration {\n  const normalized = createAdapterRegistration(registration);\n  registry.set(normalized.id, normalized);\n  return normalized;\n}\n\nexport function getRegisteredAdapter(id: string): AdapterRegistration | undefined {\n  return registry.get(id);\n}\n\nexport function listRegisteredAdapters(): readonly AdapterRegistration[] {\n  return [...registry.values()].sort((a, b) => a.id.localeCompare(b.id));\n}\n\nexport function clearAdapterRegistry(): void {\n  registry.clear();\n}\n","import type { PersistedInspectEvent } from \"agent-inspect/persisted\";\n\nexport interface InspectNodeLike {\n  event: { kind: string };\n  children: InspectNodeLike[];\n}\n\nexport function eventsToJsonl(events: readonly unknown[]): string {\n  return `${events.map((event) => JSON.stringify(event)).join(\"\\n\")}\\n`;\n}\n\nexport function flattenInspectNodes(nodes: readonly InspectNodeLike[]): InspectNodeLike[] {\n  return nodes.flatMap((node) => [node, ...flattenInspectNodes(node.children)]);\n}\n\nexport function extractPersistedKinds(\n  events: readonly PersistedInspectEvent[],\n): PersistedInspectEvent[\"kind\"][] {\n  return events.map((event) => event.kind);\n}\n\nexport function stableStringify(value: unknown): string {\n  return JSON.stringify(sortJson(value)) ?? \"null\";\n}\n\nfunction sortJson(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => sortJson(item));\n  }\n  if (isPlainRecord(value)) {\n    const sorted: Record<string, unknown> = {};\n    for (const key of Object.keys(value).sort()) {\n      sorted[key] = sortJson(value[key]);\n    }\n    return sorted;\n  }\n  return value === undefined ? null : value;\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import type { AdapterFixtureSkeleton } from \"./types.js\";\n\nconst DEFAULT_COVERS = [\n  \"run\",\n  \"step\",\n  \"tool\",\n  \"llm\",\n  \"error\",\n  \"streaming\",\n  \"metadata-bounds\",\n] as const;\n\nexport function createAdapterFixtureSkeleton(adapterId: string): AdapterFixtureSkeleton {\n  return {\n    adapterId,\n    captureDefault: \"metadata-only\",\n    network: \"none\",\n    suggestedCovers: [...DEFAULT_COVERS],\n    notes: [\n      \"Use local mocks only; no provider API keys or network calls.\",\n      \"Persist metadata-only by default; opt into preview/full capture explicitly.\",\n      \"Include forbidden raw strings in conformance tests when prompts are mocked.\",\n      \"Run runAdapterConformance against captured PersistedInspectEvent arrays.\",\n    ],\n  };\n}\n\nexport function createConformanceFixtureMeta(adapterId: string) {\n  return {\n    adapterId,\n    defaults: {\n      network: \"none\",\n      upload: \"none\",\n      capture: \"metadata-only\",\n    },\n    skeleton: createAdapterFixtureSkeleton(adapterId),\n  };\n}\n","import type {\n  ConformanceCheck,\n  PrivacyChecklistInput,\n  PrivacyChecklistItem,\n  PrivacyChecklistResult,\n} from \"./types.js\";\n\nexport const PRIVACY_CHECKLIST_ITEMS: readonly PrivacyChecklistItem[] = [\n  {\n    id: \"capture-metadata-only-default\",\n    label: \"Default capture is metadata-only (no full prompts/outputs on disk)\",\n    required: true,\n  },\n  {\n    id: \"no-network-by-default\",\n    label: \"Adapter tests and defaults do not call external networks\",\n    required: true,\n  },\n  {\n    id: \"no-upload\",\n    label: \"Adapter does not upload traces or logs to vendors by default\",\n    required: true,\n  },\n  {\n    id: \"redaction-documented\",\n    label: \"Redaction/capture modes are documented for adapter users\",\n    required: true,\n  },\n  {\n    id: \"framework-deps-scoped\",\n    label: \"Framework SDK dependencies stay in the optional adapter package\",\n    required: true,\n  },\n] as const;\n\nexport function runPrivacyChecklist(input: PrivacyChecklistInput = {}): PrivacyChecklistResult {\n  const captureMode = input.captureMode ?? \"metadata-only\";\n  const items: ConformanceCheck[] = [\n    {\n      id: \"capture-metadata-only-default\",\n      ok: captureMode === \"metadata-only\",\n      detail:\n        captureMode === \"metadata-only\"\n          ? undefined\n          : `captureMode is ${captureMode}; metadata-only is required by default`,\n    },\n    {\n      id: \"no-network-by-default\",\n      ok: input.networkAllowed !== true,\n      detail: input.networkAllowed ? \"network must be disabled in adapter defaults\" : undefined,\n    },\n    {\n      id: \"no-upload\",\n      ok: input.uploadAllowed !== true,\n      detail: input.uploadAllowed ? \"upload must not be enabled by default\" : undefined,\n    },\n    {\n      id: \"redaction-documented\",\n      ok: input.redactionDocumented !== false,\n      detail:\n        input.redactionDocumented === false\n          ? \"document capture/redaction behavior in adapter README\"\n          : undefined,\n    },\n    {\n      id: \"framework-deps-scoped\",\n      ok: input.frameworkDepsPackageScoped !== false,\n      detail:\n        input.frameworkDepsPackageScoped === false\n          ? \"keep framework SDK deps out of agent-inspect root/core\"\n          : undefined,\n    },\n  ];\n\n  const requiredFailed = items.some(\n    (item) =>\n      PRIVACY_CHECKLIST_ITEMS.find((def) => def.id === item.id)?.required && !item.ok,\n  );\n\n  return { ok: !requiredFailed, items };\n}\n","import {\n  persistedInspectEventsToRunTrees,\n  persistedInspectEventsToTraceEvents,\n  type PersistedInspectEvent,\n} from \"agent-inspect/persisted\";\nimport { openTrace, readTrace } from \"agent-inspect/readers\";\n\nimport { eventsToJsonl, flattenInspectNodes, stableStringify } from \"./mapping.js\";\nimport type {\n  AdapterConformanceOptions,\n  AdapterConformanceResult,\n  ConformanceCheck,\n} from \"./types.js\";\n\nexport async function runAdapterConformance(\n  options: AdapterConformanceOptions,\n): Promise<AdapterConformanceResult> {\n  const checks: ConformanceCheck[] = [];\n  const { adapterId, events } = options;\n\n  checks.push({\n    id: \"events-non-empty\",\n    ok: events.length > 0,\n    detail: events.length > 0 ? undefined : \"expected at least one persisted event\",\n  });\n\n  const schemaOk = events.every(\n    (event) => event.schemaVersion === \"0.2\" || event.schemaVersion === \"1.0\",\n  );\n  checks.push({\n    id: \"schema-persisted\",\n    ok: schemaOk,\n    detail: schemaOk ? undefined : \"all events must use schemaVersion 0.2 or 1.0\",\n  });\n\n  if (options.forbiddenRawStrings && options.forbiddenRawStrings.length > 0) {\n    const serialized = JSON.stringify(events);\n    const leaks = options.forbiddenRawStrings.filter((raw) => serialized.includes(raw));\n    checks.push({\n      id: \"no-forbidden-raw-strings\",\n      ok: leaks.length === 0,\n      detail:\n        leaks.length === 0 ? undefined : `forbidden raw strings leaked: ${leaks.join(\", \")}`,\n    });\n  }\n\n  try {\n    const trees = persistedInspectEventsToRunTrees([...events]);\n    checks.push({\n      id: \"run-tree-built\",\n      ok: trees.length > 0,\n      detail: trees.length > 0 ? undefined : \"persistedInspectEventsToRunTrees returned no runs\",\n    });\n\n    if (options.expectedKinds && options.expectedKinds.length > 0 && trees[0]) {\n      const kinds = flattenInspectNodes(trees[0].children).map((node) => node.event.kind);\n      const kindsOk = stableStringify(kinds) === stableStringify([...options.expectedKinds]);\n      checks.push({\n        id: \"expected-kinds\",\n        ok: kindsOk,\n        detail: kindsOk\n          ? undefined\n          : `expected kinds ${options.expectedKinds.join(\",\")} but got ${kinds.join(\",\")}`,\n      });\n    }\n\n    const normalized = persistedInspectEventsToTraceEvents([...events]);\n    checks.push({\n      id: \"legacy-normalization\",\n      ok: normalized.length > 0,\n      detail:\n        normalized.length > 0 ? undefined : \"persistedInspectEventsToTraceEvents returned empty\",\n    });\n\n    const input = { type: \"string\" as const, content: eventsToJsonl(events) };\n    const read = await readTrace(input, { format: \"agent-inspect-jsonl\" });\n    const opened = await openTrace(input, { format: \"agent-inspect-jsonl\" });\n    const roundTripOk = stableStringify(read.runs) === stableStringify(opened.runs);\n    checks.push({\n      id: \"reader-round-trip\",\n      ok: roundTripOk,\n      detail: roundTripOk ? undefined : \"readTrace and openTrace runs differ\",\n    });\n  } catch (error) {\n    checks.push({\n      id: \"conformance-runtime\",\n      ok: false,\n      detail: error instanceof Error ? error.message : String(error),\n    });\n  }\n\n  return {\n    ok: checks.every((check) => check.ok),\n    adapterId,\n    checks,\n  };\n}\n\nexport function findPairedLifecycle(\n  events: readonly PersistedInspectEvent[],\n  kind: PersistedInspectEvent[\"kind\"],\n  terminalStatus: \"ok\" | \"error\" = \"ok\",\n): { started?: PersistedInspectEvent; completed?: PersistedInspectEvent } {\n  const ofKind = events.filter((event) => event.kind === kind);\n  const started = ofKind.find((event) => event.status === \"running\");\n  const completed = ofKind.find(\n    (event) => event.status === terminalStatus || event.status === \"error\",\n  );\n  if (started !== undefined || completed === undefined) {\n    return { started, completed };\n  }\n  const completedById = completed;\n  const startedById = ofKind.find(\n    (event) => event.eventId === completedById.eventId && event.status === \"running\",\n  );\n  return { started: startedById, completed: completedById };\n}\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agent-inspect/adapter-sdk",
+  "version": "2.6.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Adapter authoring toolkit with conformance and privacy helpers",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rajudandigam/agent-inspect.git",
+    "directory": "packages/adapter-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/rajudandigam/agent-inspect/issues"
+  },
+  "homepage": "https://github.com/rajudandigam/agent-inspect#readme",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "agent-inspect": "2.6.0"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm --workspace-root exec tsup --config tsup.adapter-sdk.config.ts",
+    "test": "vitest run -c ../../vitest.config.ts"
+  }
+}