@tangle-network/agent-runtime 0.89.0 → 0.90.1

package/dist/intelligence.js

@@ -2,9 +2,147 @@ import {
   buildLoopOtelSpans,
   createOtelExporter,
   flatOtelSpan
-} from "./chunk-UD4BHQMI.js";
+} from "./chunk-IVGYLCFH.js";
 import "./chunk-DGUM43GV.js";
 
+// src/intelligence/delivery.ts
+var defaultPlaneBaseUrl = "https://intelligence.tangle.tools";
+var defaultRefreshMs = 3e5;
+var defaultPullTimeoutMs = 1e4;
+function resolveIntelligenceBaseUrl(baseUrl) {
+  if (baseUrl) return baseUrl.replace(/\/+$/, "");
+  if (typeof process !== "undefined" && process.env.TANGLE_INTELLIGENCE_URL) {
+    return process.env.TANGLE_INTELLIGENCE_URL.replace(/\/+$/, "");
+  }
+  return defaultPlaneBaseUrl;
+}
+function resolveApiKey(apiKey) {
+  if (apiKey) return apiKey;
+  if (typeof process !== "undefined" && process.env.TANGLE_API_KEY)
+    return process.env.TANGLE_API_KEY;
+  return "";
+}
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function toDiffProvenance(value) {
+  const p = asRecord(value);
+  return {
+    version: typeof p.version === "number" ? p.version : null,
+    lift: typeof p.lift === "string" ? p.lift : null,
+    contentHash: typeof p.contentHash === "string" ? p.contentHash : "",
+    promotedAt: typeof p.promotedAt === "string" ? p.promotedAt : ""
+  };
+}
+function normalizeCertifiedProfile(raw) {
+  const r = asRecord(raw);
+  const promptSurface = r.promptSurface ? r.promptSurface : null;
+  const artifacts = r.artifacts ?? {};
+  const agentProfileDiffs = Array.isArray(r.agentProfileDiffs) ? r.agentProfileDiffs.map((entry) => {
+    const e = asRecord(entry);
+    return { diff: e.diff, provenance: toDiffProvenance(e.provenance) };
+  }) : [];
+  const capabilities = Array.isArray(r.capabilities) ? r.capabilities : [];
+  return {
+    target: typeof r.target === "string" ? r.target : "",
+    generatedAt: typeof r.generatedAt === "string" ? r.generatedAt : "",
+    promptSurface,
+    artifacts,
+    agentProfileDiffs,
+    capabilities,
+    agentProfile: r.agentProfile ?? null
+  };
+}
+async function pullCertified(opts) {
+  const doFetch = opts.fetchImpl ?? globalThis.fetch;
+  if (!doFetch) return { succeeded: false, error: "no fetch implementation available" };
+  const apiKey = resolveApiKey(opts.apiKey);
+  if (!apiKey) return { succeeded: false, error: "no apiKey (set TANGLE_API_KEY or opts.apiKey)" };
+  const baseUrl = resolveIntelligenceBaseUrl(opts.baseUrl);
+  const url = `${baseUrl}/v1/profiles/${encodeURIComponent(opts.target)}/composed`;
+  let res;
+  try {
+    res = await doFetch(url, {
+      headers: { authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(opts.timeoutMs ?? defaultPullTimeoutMs)
+    });
+  } catch (err) {
+    return {
+      succeeded: false,
+      error: `pull request failed: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+  if (res.status === 404) {
+    return {
+      succeeded: false,
+      error: "no certified artifacts promoted for target yet",
+      status: 404
+    };
+  }
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    return {
+      succeeded: false,
+      error: `pull ${res.status}: ${body.slice(0, 200)}`,
+      status: res.status
+    };
+  }
+  try {
+    return { succeeded: true, value: normalizeCertifiedProfile(await res.json()) };
+  } catch (err) {
+    return {
+      succeeded: false,
+      error: `pull response parse failed: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
+var promptFoldTypes = ["prompt-surface", "skill", "instructions"];
+function composeCertifiedPrompt(base, certified) {
+  if (!certified) return base;
+  const parts = [];
+  if (certified.promptSurface?.surface.trim()) parts.push(certified.promptSurface.surface.trim());
+  for (const type of promptFoldTypes) {
+    const bucket = certified.artifacts[type] ?? [];
+    for (const a of [...bucket].sort((x, y) => (x.path ?? "").localeCompare(y.path ?? ""))) {
+      if (a.content.trim()) parts.push(a.content.trim());
+    }
+  }
+  if (parts.length === 0) return base;
+  return `${base.trim()}
+
+## Certified guidance (Tangle Intelligence)
+
+${parts.join("\n\n")}`;
+}
+function createCertifiedPromptSource(opts) {
+  const refreshMs = opts.refreshMs ?? defaultRefreshMs;
+  let certified = null;
+  let lastPullAt = 0;
+  let inflight = null;
+  async function refresh() {
+    if (Date.now() - lastPullAt < refreshMs) return;
+    if (inflight) return inflight;
+    inflight = (async () => {
+      const outcome = await pullCertified(opts);
+      lastPullAt = Date.now();
+      if (outcome.succeeded) certified = outcome.value;
+    })();
+    try {
+      await inflight;
+    } finally {
+      inflight = null;
+    }
+  }
+  return {
+    refresh,
+    current: () => certified,
+    async compose(base) {
+      await refresh();
+      return composeCertifiedPrompt(base, certified);
+    }
+  };
+}
+
 // src/intelligence/effort.ts
 var presets = {
   off: {
@@ -247,142 +385,6 @@ function isJsonSchema(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 
-// src/intelligence/delivery.ts
-var defaultPlaneBaseUrl = "https://intelligence.tangle.tools";
-var defaultRefreshMs = 3e5;
-var defaultPullTimeoutMs = 1e4;
-function resolvePlaneBaseUrl(baseUrl) {
-  if (baseUrl) return baseUrl.replace(/\/+$/, "");
-  if (typeof process !== "undefined" && process.env.TANGLE_INTELLIGENCE_URL) {
-    return process.env.TANGLE_INTELLIGENCE_URL.replace(/\/+$/, "");
-  }
-  return defaultPlaneBaseUrl;
-}
-function resolveApiKey(apiKey) {
-  if (apiKey) return apiKey;
-  if (typeof process !== "undefined" && process.env.TANGLE_API_KEY)
-    return process.env.TANGLE_API_KEY;
-  return "";
-}
-async function pullCertified(opts) {
-  const doFetch = opts.fetchImpl ?? globalThis.fetch;
-  if (!doFetch) return { succeeded: false, error: "no fetch implementation available" };
-  const apiKey = resolveApiKey(opts.apiKey);
-  if (!apiKey) return { succeeded: false, error: "no apiKey (set TANGLE_API_KEY or opts.apiKey)" };
-  const baseUrl = resolvePlaneBaseUrl(opts.baseUrl);
-  const url = `${baseUrl}/v1/profiles/${encodeURIComponent(opts.target)}/composed`;
-  let res;
-  try {
-    res = await doFetch(url, {
-      headers: { authorization: `Bearer ${apiKey}` },
-      signal: AbortSignal.timeout(opts.timeoutMs ?? defaultPullTimeoutMs)
-    });
-  } catch (err) {
-    return {
-      succeeded: false,
-      error: `pull request failed: ${err instanceof Error ? err.message : String(err)}`
-    };
-  }
-  if (res.status === 404) {
-    return {
-      succeeded: false,
-      error: "no certified artifacts promoted for target yet",
-      status: 404
-    };
-  }
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    return {
-      succeeded: false,
-      error: `pull ${res.status}: ${body.slice(0, 200)}`,
-      status: res.status
-    };
-  }
-  try {
-    return { succeeded: true, value: await res.json() };
-  } catch (err) {
-    return {
-      succeeded: false,
-      error: `pull response parse failed: ${err instanceof Error ? err.message : String(err)}`
-    };
-  }
-}
-var promptFoldTypes = ["prompt-surface", "skill", "instructions"];
-function composeCertifiedPrompt(base, certified) {
-  if (!certified) return base;
-  const parts = [];
-  if (certified.promptSurface?.surface.trim()) parts.push(certified.promptSurface.surface.trim());
-  for (const type of promptFoldTypes) {
-    const bucket = certified.artifacts[type] ?? [];
-    for (const a of [...bucket].sort((x, y) => (x.path ?? "").localeCompare(y.path ?? ""))) {
-      if (a.content.trim()) parts.push(a.content.trim());
-    }
-  }
-  if (parts.length === 0) return base;
-  return `${base.trim()}
-
-## Certified guidance (Tangle Intelligence)
-
-${parts.join("\n\n")}`;
-}
-function createCertifiedPromptSource(opts) {
-  const refreshMs = opts.refreshMs ?? defaultRefreshMs;
-  let certified = null;
-  let lastPullAt = 0;
-  let inflight = null;
-  async function refresh() {
-    if (Date.now() - lastPullAt < refreshMs) return;
-    if (inflight) return inflight;
-    inflight = (async () => {
-      const outcome = await pullCertified(opts);
-      lastPullAt = Date.now();
-      if (outcome.succeeded) certified = outcome.value;
-    })();
-    try {
-      await inflight;
-    } finally {
-      inflight = null;
-    }
-  }
-  return {
-    refresh,
-    current: () => certified,
-    async compose(base) {
-      await refresh();
-      return composeCertifiedPrompt(base, certified);
-    }
-  };
-}
-function withCertifiedDelivery(agent, config) {
-  const client = createIntelligenceClient(config);
-  const source = createCertifiedPromptSource({
-    target: config.target ?? config.project,
-    ...config.apiKey !== void 0 ? { apiKey: config.apiKey } : {},
-    ...config.baseUrl !== void 0 ? { baseUrl: config.baseUrl } : {},
-    ...config.timeoutMs !== void 0 ? { timeoutMs: config.timeoutMs } : {},
-    ...config.fetchImpl !== void 0 ? { fetchImpl: config.fetchImpl } : {},
-    ...config.refreshMs !== void 0 ? { refreshMs: config.refreshMs } : {}
-  });
-  const wrapped = (async (input) => {
-    await source.refresh();
-    const certified = source.current();
-    const applied = {
-      certified,
-      composePrompt: (base) => composeCertifiedPrompt(base, certified)
-    };
-    return client.traceRun(
-      { input, labels: { "tangle.certified_version": certified?.promptSurface?.version ?? -1 } },
-      async (trace) => {
-        const out = await agent(input, applied);
-        trace.recordOutput(out);
-        return out;
-      }
-    );
-  });
-  wrapped.refresh = source.refresh;
-  return wrapped;
-}
-
 // src/intelligence/resolver.ts
 function emptyAccumulator() {
   return {
@@ -415,8 +417,6 @@ async function composeCertifiedProfile(base, manifest, ctx = {}) {
   await driftDropTools(acc, ctx);
   const promptAdditions = collectPromptAdditions(manifest.promptSurface, acc.contextArtifacts);
   const systemPrompt = composeCertifiedPrompt(base.systemPrompt, {
-    target: manifest.target,
-    generatedAt: manifest.generatedAt,
     promptSurface: manifest.promptSurface,
     artifacts: acc.contextArtifacts
   });
@@ -445,8 +445,6 @@ async function composeCertifiedProfile(base, manifest, ctx = {}) {
 }
 function baseSurface(systemPrompt, promptSurface) {
   const folded = composeCertifiedPrompt(systemPrompt, {
-    target: "",
-    generatedAt: "",
     promptSurface,
     artifacts: {}
   });
@@ -762,17 +760,80 @@ async function composeCertifiedProfileFromWire(base, profile, ctx = {}) {
   return composeCertifiedProfile(base, manifestFromProfile(profile), ctx);
 }
 
+// src/intelligence/with-intelligence.ts
+import { applyAgentProfileDiff } from "@tangle-network/agent-interface";
+function withIntelligence(agent, config) {
+  const client = createIntelligenceClient(config);
+  const target = config.target ?? config.project;
+  const source = createCertifiedPromptSource({
+    target,
+    ...config.apiKey !== void 0 ? { apiKey: config.apiKey } : {},
+    ...config.baseUrl !== void 0 ? { baseUrl: config.baseUrl } : {},
+    ...config.timeoutMs !== void 0 ? { timeoutMs: config.timeoutMs } : {},
+    ...config.fetchImpl !== void 0 ? { fetchImpl: config.fetchImpl } : {},
+    ...config.refreshMs !== void 0 ? { refreshMs: config.refreshMs } : {}
+  });
+  const currentProposals = () => source.current()?.agentProfileDiffs ?? [];
+  let lastSignal = "";
+  function signalProposals() {
+    const proposals = currentProposals();
+    if (proposals.length === 0) return;
+    const sig = proposals.map((p) => p.provenance.contentHash).join("|");
+    if (sig === lastSignal) return;
+    lastSignal = sig;
+    config.onProposals?.(proposals);
+  }
+  async function refresh() {
+    await source.refresh();
+    signalProposals();
+  }
+  const wrapped = (async (input) => {
+    await refresh();
+    const certified = source.current();
+    const proposals = currentProposals();
+    const report = {};
+    const applied = {
+      certified,
+      composePrompt: (base) => composeCertifiedPrompt(base, certified),
+      proposals,
+      applyProfile: (base) => proposals.reduce((profile, p) => applyAgentProfileDiff(profile, p.diff), base),
+      record: (r) => Object.assign(report, r)
+    };
+    const output = await agent(input, applied);
+    const usage = {
+      inferenceUsd: report.usage?.inferenceUsd ?? report.costUsd ?? 0,
+      intelligenceUsd: report.usage?.intelligenceUsd ?? 0
+    };
+    const record = {
+      runId: client.freshRunId(),
+      traceId: client.freshTraceId(),
+      project: config.project,
+      target,
+      input,
+      output,
+      outcome: {
+        ...report.success !== void 0 ? { success: report.success } : {},
+        ...report.score !== void 0 ? { score: report.score } : {},
+        usage
+      },
+      ...report.model !== void 0 ? { model: report.model } : {},
+      ...report.provider !== void 0 ? { provider: report.provider } : {},
+      ...report.loopEvents !== void 0 ? { loopEvents: report.loopEvents } : {}
+    };
+    client.exportRunRecord(record);
+    return output;
+  });
+  wrapped.refresh = refresh;
+  wrapped.proposals = currentProposals;
+  return wrapped;
+}
+
 // src/intelligence/index.ts
 function resolveEffortConfig(effort) {
   if (effort === void 0) return resolveEffort(defaultEffortTier);
   if (typeof effort === "string") return resolveEffort(effort);
   return resolveEffort(effort.tier, effort.overrides);
 }
-function resolveEndpoint(endpoint) {
-  if (endpoint) return endpoint;
-  if (typeof process === "undefined") return void 0;
-  return process.env.INTELLIGENCE_OTLP_ENDPOINT ?? process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
-}
 function freshTraceId() {
   return randomHex(32);
 }
@@ -809,16 +870,16 @@ function createIntelligenceClient(config) {
   const intelligenceOff = isIntelligenceOff(effort);
   const redactor = resolveRedactor(config.redact);
   const apiKey = config.apiKey ?? (typeof process !== "undefined" ? process.env.TANGLE_API_KEY : void 0);
-  const endpoint = resolveEndpoint(config.endpoint);
+  const otlpEndpoint = `${resolveIntelligenceBaseUrl(config.baseUrl)}/v1/otlp`;
   let exporter;
   let exporterResolved = false;
   function getExporter() {
     if (exporterResolved) return exporter;
     exporterResolved = true;
-    if (!endpoint) return void 0;
+    if (!apiKey) return void 0;
     exporter = createOtelExporter({
-      endpoint,
-      headers: apiKey ? { authorization: `Bearer ${apiKey}` } : {},
+      endpoint: otlpEndpoint,
+      headers: { authorization: `Bearer ${apiKey}` },
       serviceName: config.project,
       resourceAttributes: { "tangle.project": config.project }
     });
@@ -854,9 +915,51 @@ function createIntelligenceClient(config) {
     } catch {
     }
   }
+  function exportRunRecord(record) {
+    const ex = getExporter();
+    if (!ex) return record.traceId;
+    const intelligenceUsd = intelligenceOff ? 0 : record.outcome.usage.intelligenceUsd;
+    const labels = {
+      project: record.project,
+      "tangle.target": record.target,
+      "tangle.effort.intelligence_off": intelligenceOff,
+      "tangle.usage.inference_usd": record.outcome.usage.inferenceUsd,
+      "tangle.usage.intelligence_usd": intelligenceUsd,
+      ...record.model ? { "gen_ai.request.model": record.model } : {},
+      ...record.provider ? { "provider.name": record.provider } : {},
+      ...typeof record.outcome.success === "boolean" ? { "tangle.outcome.success": record.outcome.success } : {},
+      ...typeof record.outcome.score === "number" ? { "tangle.outcome.score": record.outcome.score } : {}
+    };
+    const redactedInput = record.input !== void 0 ? redactor(record.input) : void 0;
+    const redactedOutput = record.output !== void 0 ? redactor(record.output) : void 0;
+    if (redactedInput !== void 0) labels["tangle.input"] = previewJson(redactedInput);
+    if (redactedOutput !== void 0) labels["tangle.output"] = previewJson(redactedOutput);
+    try {
+      const runSpan = flatOtelSpan(
+        "tangle.intelligence.run",
+        { "tangle.runId": record.runId, ...labels },
+        record.traceId,
+        Date.now()
+      );
+      ex.exportSpan(runSpan);
+      if (record.loopEvents && record.loopEvents.length > 0) {
+        const spans = buildLoopOtelSpans(
+          record.loopEvents,
+          record.traceId,
+          runSpan.spanId
+        );
+        for (const span of spans) ex.exportSpan(span);
+      }
+    } catch {
+    }
+    return record.traceId;
+  }
   return {
     project: config.project,
     effort,
+    exportRunRecord,
+    freshRunId,
+    freshTraceId,
     async traceRun(meta, fn) {
       const runId = meta.runId ?? freshRunId();
       const traceId = meta.traceId ?? freshTraceId();
@@ -926,7 +1029,9 @@ function createIntelligenceClient(config) {
       return {
         project: config.project,
         effort,
-        exportConfigured: Boolean(endpoint),
+        // Send ships only with a tenant key — the honest "will export actually
+        // land" signal (the base URL always resolves to the plane default).
+        exportConfigured: Boolean(apiKey),
         modes: {
           observe: { ready: true, missing: [] },
           recommend: {
@@ -947,19 +1052,6 @@ function createIntelligenceClient(config) {
     }
   };
 }
-function isClient(value) {
-  return typeof value.traceRun === "function";
-}
-function withTangleIntelligence(agent, clientOrConfig) {
-  const client = isClient(clientOrConfig) ? clientOrConfig : createIntelligenceClient(clientOrConfig);
-  return async (input) => {
-    return client.traceRun({ input }, async (trace) => {
-      const output = await agent(input);
-      trace.recordOutput(output);
-      return output;
-    });
-  };
-}
 export {
   CapabilityNotAdmittedError,
   compileEffort,
@@ -972,10 +1064,11 @@ export {
   defaultRedactor,
   isIntelligenceOff,
   manifestFromProfile,
+  normalizeCertifiedProfile,
   pullCertified,
   resolveEffort,
+  resolveIntelligenceBaseUrl,
   resolveRedactor,
-  withCertifiedDelivery,
-  withTangleIntelligence
+  withIntelligence
 };
 //# sourceMappingURL=intelligence.js.map