@agentronics/sdk 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as _agentronics_protocol from '@agentronics/protocol';
 import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
-import { T as TraceExporter, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-Cwll8MGz.cjs';
-export { a as AgentContextListener, b as AgentContextSnapshot, c as AgentContextStore, d as AuthEngine, e as AuthInput, f as AuthMethod, C as CRAWLER_SIGNATURES, g as CrawlerCategory, h as CrawlerSignature, i as DEFAULT_GROUP, j as DetectCrawlerOptions, k as DetectDomOptions, l as Detector, m as DetectorRegistry, n as DetectorStatus, o as DomSignalName, G as GovernedTool, p as IdentityStore, M as MemoryCache, q as MemoryStore, r as PolicyCache, s as PresentIdentityOptions, t as PresentedIdentity, u as ProgressionConfig, v as ProgressionStage, w as ProgressionStore, x as ProgressionTransition, y as ProvideForPageInput, R as RateLimiter, S as SiteMemoryListener, z as SiteMemoryStore, B as SurfacingContext, E as SurfacingDecision, F as TokenBudgetReport, H as ToolGroupSummary, J as ToolRegistry, K as ToolTokenEstimate, L as TraceInput, N as Tracer, W as WebMcpAdapter, O as WebMcpAdapterOptions, Q as WebMcpProvider, U as WebMcpToolDescriptor, V as bundledDetectors, X as createAgentContextStore, Y as createAuthEngine, Z as createDetectorRegistry, _ as createIdentityStore, $ as createMemoryCache, a0 as createMemoryStore, a1 as createPolicyCache, a2 as createPolicyEngine, a3 as createProgressionStore, a4 as createRateLimiter, a5 as createSiteMemoryStore, a6 as createToolRegistry, a7 as createTracer, a8 as createWebMcpAdapter, a9 as decideSurfacing, aa as detectAgent, ab as detectCrawler, ac as detectDom, ad as estimateBudget, ae as estimateToolTokens, af as explainSurfacing, ag as groupTools, ah as init, ai as listGroupNames, aj as surfaceTools } from './init-only-Cwll8MGz.cjs';
+import { T as TraceExporter, G as GovernedTool, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-Cwll8MGz.cjs';
+export { a as AgentContextListener, b as AgentContextSnapshot, c as AgentContextStore, d as AuthEngine, e as AuthInput, f as AuthMethod, C as CRAWLER_SIGNATURES, g as CrawlerCategory, h as CrawlerSignature, i as DEFAULT_GROUP, j as DetectCrawlerOptions, k as DetectDomOptions, l as Detector, m as DetectorRegistry, n as DetectorStatus, o as DomSignalName, p as IdentityStore, M as MemoryCache, q as MemoryStore, r as PolicyCache, s as PresentIdentityOptions, t as PresentedIdentity, u as ProgressionConfig, v as ProgressionStage, w as ProgressionStore, x as ProgressionTransition, y as ProvideForPageInput, R as RateLimiter, S as SiteMemoryListener, z as SiteMemoryStore, B as SurfacingContext, E as SurfacingDecision, F as TokenBudgetReport, H as ToolGroupSummary, J as ToolRegistry, K as ToolTokenEstimate, L as TraceInput, N as Tracer, W as WebMcpAdapter, O as WebMcpAdapterOptions, Q as WebMcpProvider, U as WebMcpToolDescriptor, V as bundledDetectors, X as createAgentContextStore, Y as createAuthEngine, Z as createDetectorRegistry, _ as createIdentityStore, $ as createMemoryCache, a0 as createMemoryStore, a1 as createPolicyCache, a2 as createPolicyEngine, a3 as createProgressionStore, a4 as createRateLimiter, a5 as createSiteMemoryStore, a6 as createToolRegistry, a7 as createTracer, a8 as createWebMcpAdapter, a9 as decideSurfacing, aa as detectAgent, ab as detectCrawler, ac as detectDom, ad as estimateBudget, ae as estimateToolTokens, af as explainSurfacing, ag as groupTools, ah as init, ai as listGroupNames, aj as surfaceTools } from './init-only-Cwll8MGz.cjs';
 export { D as DetectWebMcpOptions, d as detectWebMcp } from './webmcp-C4ikhM4g.cjs';
 
 interface DeclareAgentInput {
@@ -51,6 +51,51 @@ interface WebhookExporterOptions {
 }
 declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }: WebhookExporterOptions) => TraceExporter;
 
+interface IntelExporterOptions {
+    /**
+     * Intelligence API base URL (e.g. `https://intel-api-….run.app`) — the
+     * `/v1/sdk/events` path is appended automatically — or the full ingest URL.
+     */
+    url: string;
+    /**
+     * Per-tenant SDK ingest key (`agtx_ik_…`), minted in the dashboard Settings.
+     * This is a **secret**: use this exporter in your backend only, never in the
+     * browser. (The browser SDK should forward traces to your backend, which
+     * relays them with the key.)
+     */
+    ingestKey: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * Stream governed-action traces to the Agentronics Intelligence dashboard.
+ * POSTs a `TraceBatch` to the intel-api ingest endpoint with the ingest key.
+ * Intended for Node/server use (the existing webhook exporter is browser-bound
+ * and can't send an auth header).
+ */
+declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+interface IntelSyncOptions {
+    /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
+    url: string;
+    /** Per-tenant SDK ingest key (`agtx_ik_…`). Backend-only — never the browser. */
+    ingestKey: string;
+    /** The site these tools/memory belong to (matches your SDK `siteId`). */
+    siteId: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * Push the authoritative tool registry + site-memory snapshot to the
+ * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
+ * which is too large for the lightweight trace stream. Call after `syncTools()`
+ * / `provideSiteMemory(...)`. Backend/server use only (the key is secret).
+ */
+interface IntelSync {
+    /** POST the registry to /v1/sdk/tools. Returns the number of tools sent. */
+    pushTools(tools: GovernedTool[]): Promise<number>;
+    /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
+    pushMemory(snapshot: object, score?: number): Promise<void>;
+}
+declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
+
 interface TrustDerivationInput {
     detected?: boolean;
     declared?: boolean;
@@ -143,4 +188,4 @@ declare const Agentronics: {
 };
 declare const VERSION = "0.1.0";
 
-export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, InitOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createSignatureLoader, createTraceBuffer, createWebMcpContextTool, createWebhookExporter, declareAgent, deriveTrustLevel, fetchWellKnownContext, highestTrust, installDomEnforcer, installMemoryOverlay, installMetaTags, serializeWellKnownContext, showDenyOverlay };
+export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, GovernedTool, InitOptions, type IntelExporterOptions, type IntelSync, type IntelSyncOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createIntelExporter, createIntelSync, createSignatureLoader, createTraceBuffer, createWebMcpContextTool, createWebhookExporter, declareAgent, deriveTrustLevel, fetchWellKnownContext, highestTrust, installDomEnforcer, installMemoryOverlay, installMetaTags, serializeWellKnownContext, showDenyOverlay };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _agentronics_protocol from '@agentronics/protocol';
 import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
-import { T as TraceExporter, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-7f8_LQAI.js';
-export { a as AgentContextListener, b as AgentContextSnapshot, c as AgentContextStore, d as AuthEngine, e as AuthInput, f as AuthMethod, C as CRAWLER_SIGNATURES, g as CrawlerCategory, h as CrawlerSignature, i as DEFAULT_GROUP, j as DetectCrawlerOptions, k as DetectDomOptions, l as Detector, m as DetectorRegistry, n as DetectorStatus, o as DomSignalName, G as GovernedTool, p as IdentityStore, M as MemoryCache, q as MemoryStore, r as PolicyCache, s as PresentIdentityOptions, t as PresentedIdentity, u as ProgressionConfig, v as ProgressionStage, w as ProgressionStore, x as ProgressionTransition, y as ProvideForPageInput, R as RateLimiter, S as SiteMemoryListener, z as SiteMemoryStore, B as SurfacingContext, E as SurfacingDecision, F as TokenBudgetReport, H as ToolGroupSummary, J as ToolRegistry, K as ToolTokenEstimate, L as TraceInput, N as Tracer, W as WebMcpAdapter, O as WebMcpAdapterOptions, Q as WebMcpProvider, U as WebMcpToolDescriptor, V as bundledDetectors, X as createAgentContextStore, Y as createAuthEngine, Z as createDetectorRegistry, _ as createIdentityStore, $ as createMemoryCache, a0 as createMemoryStore, a1 as createPolicyCache, a2 as createPolicyEngine, a3 as createProgressionStore, a4 as createRateLimiter, a5 as createSiteMemoryStore, a6 as createToolRegistry, a7 as createTracer, a8 as createWebMcpAdapter, a9 as decideSurfacing, aa as detectAgent, ab as detectCrawler, ac as detectDom, ad as estimateBudget, ae as estimateToolTokens, af as explainSurfacing, ag as groupTools, ah as init, ai as listGroupNames, aj as surfaceTools } from './init-only-7f8_LQAI.js';
+import { T as TraceExporter, G as GovernedTool, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-7f8_LQAI.js';
+export { a as AgentContextListener, b as AgentContextSnapshot, c as AgentContextStore, d as AuthEngine, e as AuthInput, f as AuthMethod, C as CRAWLER_SIGNATURES, g as CrawlerCategory, h as CrawlerSignature, i as DEFAULT_GROUP, j as DetectCrawlerOptions, k as DetectDomOptions, l as Detector, m as DetectorRegistry, n as DetectorStatus, o as DomSignalName, p as IdentityStore, M as MemoryCache, q as MemoryStore, r as PolicyCache, s as PresentIdentityOptions, t as PresentedIdentity, u as ProgressionConfig, v as ProgressionStage, w as ProgressionStore, x as ProgressionTransition, y as ProvideForPageInput, R as RateLimiter, S as SiteMemoryListener, z as SiteMemoryStore, B as SurfacingContext, E as SurfacingDecision, F as TokenBudgetReport, H as ToolGroupSummary, J as ToolRegistry, K as ToolTokenEstimate, L as TraceInput, N as Tracer, W as WebMcpAdapter, O as WebMcpAdapterOptions, Q as WebMcpProvider, U as WebMcpToolDescriptor, V as bundledDetectors, X as createAgentContextStore, Y as createAuthEngine, Z as createDetectorRegistry, _ as createIdentityStore, $ as createMemoryCache, a0 as createMemoryStore, a1 as createPolicyCache, a2 as createPolicyEngine, a3 as createProgressionStore, a4 as createRateLimiter, a5 as createSiteMemoryStore, a6 as createToolRegistry, a7 as createTracer, a8 as createWebMcpAdapter, a9 as decideSurfacing, aa as detectAgent, ab as detectCrawler, ac as detectDom, ad as estimateBudget, ae as estimateToolTokens, af as explainSurfacing, ag as groupTools, ah as init, ai as listGroupNames, aj as surfaceTools } from './init-only-7f8_LQAI.js';
 export { D as DetectWebMcpOptions, d as detectWebMcp } from './webmcp-C4ikhM4g.js';
 
 interface DeclareAgentInput {
@@ -51,6 +51,51 @@ interface WebhookExporterOptions {
 }
 declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }: WebhookExporterOptions) => TraceExporter;
 
+interface IntelExporterOptions {
+    /**
+     * Intelligence API base URL (e.g. `https://intel-api-….run.app`) — the
+     * `/v1/sdk/events` path is appended automatically — or the full ingest URL.
+     */
+    url: string;
+    /**
+     * Per-tenant SDK ingest key (`agtx_ik_…`), minted in the dashboard Settings.
+     * This is a **secret**: use this exporter in your backend only, never in the
+     * browser. (The browser SDK should forward traces to your backend, which
+     * relays them with the key.)
+     */
+    ingestKey: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * Stream governed-action traces to the Agentronics Intelligence dashboard.
+ * POSTs a `TraceBatch` to the intel-api ingest endpoint with the ingest key.
+ * Intended for Node/server use (the existing webhook exporter is browser-bound
+ * and can't send an auth header).
+ */
+declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+interface IntelSyncOptions {
+    /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
+    url: string;
+    /** Per-tenant SDK ingest key (`agtx_ik_…`). Backend-only — never the browser. */
+    ingestKey: string;
+    /** The site these tools/memory belong to (matches your SDK `siteId`). */
+    siteId: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * Push the authoritative tool registry + site-memory snapshot to the
+ * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
+ * which is too large for the lightweight trace stream. Call after `syncTools()`
+ * / `provideSiteMemory(...)`. Backend/server use only (the key is secret).
+ */
+interface IntelSync {
+    /** POST the registry to /v1/sdk/tools. Returns the number of tools sent. */
+    pushTools(tools: GovernedTool[]): Promise<number>;
+    /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
+    pushMemory(snapshot: object, score?: number): Promise<void>;
+}
+declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
+
 interface TrustDerivationInput {
     detected?: boolean;
     declared?: boolean;
@@ -143,4 +188,4 @@ declare const Agentronics: {
 };
 declare const VERSION = "0.1.0";
 
-export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, InitOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createSignatureLoader, createTraceBuffer, createWebMcpContextTool, createWebhookExporter, declareAgent, deriveTrustLevel, fetchWellKnownContext, highestTrust, installDomEnforcer, installMemoryOverlay, installMetaTags, serializeWellKnownContext, showDenyOverlay };
+export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, GovernedTool, InitOptions, type IntelExporterOptions, type IntelSync, type IntelSyncOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createIntelExporter, createIntelSync, createSignatureLoader, createTraceBuffer, createWebMcpContextTool, createWebhookExporter, declareAgent, deriveTrustLevel, fetchWellKnownContext, highestTrust, installDomEnforcer, installMemoryOverlay, installMetaTags, serializeWellKnownContext, showDenyOverlay };