@agentronics/sdk 0.4.0 → 0.6.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 {
@@ -53,7 +53,7 @@ declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }:
 
 interface IntelExporterOptions {
     /**
-     * Intelligence API base URL (e.g. `https://intel-api-….run.app`) — the
+     * Agentronics API base URL (shown in the console under Settings) — the
      * `/v1/sdk/events` path is appended automatically — or the full ingest URL.
      */
     url: string;
@@ -67,12 +67,41 @@ interface IntelExporterOptions {
     fetcher?: typeof fetch;
 }
 /**
- * Stream governed-action traces to the Agentronics Intelligence dashboard.
+ * Stream traces (agent sign-ins, verifications, access decisions) to the
+ * Agentronics 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).
  */
+/** @deprecated Use createDashboardExporter (same function). */
 declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+interface IntelSyncOptions {
+    /** Agentronics API base URL (shown in the console under Settings). */
+    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
+ * Agentronics console — 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>;
+}
+/** @deprecated Use createDashboardSync (same function). */
+declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
+/** Preferred name. Streams SDK traces to the Agentronics dashboard. */
+declare const createDashboardExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+/** Preferred name for createIntelSync. */
+declare const createDashboardSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
 
 interface TrustDerivationInput {
     detected?: boolean;
@@ -166,4 +195,4 @@ declare const Agentronics: {
 };
 declare const VERSION = "0.1.0";
 
-export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, InitOptions, type IntelExporterOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createIntelExporter, 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, createDashboardExporter, createDashboardSync, 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 {
@@ -53,7 +53,7 @@ declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }:
 
 interface IntelExporterOptions {
     /**
-     * Intelligence API base URL (e.g. `https://intel-api-….run.app`) — the
+     * Agentronics API base URL (shown in the console under Settings) — the
      * `/v1/sdk/events` path is appended automatically — or the full ingest URL.
      */
     url: string;
@@ -67,12 +67,41 @@ interface IntelExporterOptions {
     fetcher?: typeof fetch;
 }
 /**
- * Stream governed-action traces to the Agentronics Intelligence dashboard.
+ * Stream traces (agent sign-ins, verifications, access decisions) to the
+ * Agentronics 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).
  */
+/** @deprecated Use createDashboardExporter (same function). */
 declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+interface IntelSyncOptions {
+    /** Agentronics API base URL (shown in the console under Settings). */
+    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
+ * Agentronics console — 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>;
+}
+/** @deprecated Use createDashboardSync (same function). */
+declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
+/** Preferred name. Streams SDK traces to the Agentronics dashboard. */
+declare const createDashboardExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
+/** Preferred name for createIntelSync. */
+declare const createDashboardSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
 
 interface TrustDerivationInput {
     detected?: boolean;
@@ -166,4 +195,4 @@ declare const Agentronics: {
 };
 declare const VERSION = "0.1.0";
 
-export { Agentronics, AgentronicsClient, type DeclareAgentInput, DetectAgentOptions, InitOptions, type IntelExporterOptions, PolicyEngine, TraceExporter, VERSION, WELL_KNOWN_PATH, type WebMcpContextOptions, type WebMcpContextTool, createConsoleExporter, createGatewayExporter, createIntelExporter, 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, createDashboardExporter, createDashboardSync, createGatewayExporter, createIntelExporter, createIntelSync, createSignatureLoader, createTraceBuffer, createWebMcpContextTool, createWebhookExporter, declareAgent, deriveTrustLevel, fetchWellKnownContext, highestTrust, installDomEnforcer, installMemoryOverlay, installMetaTags, serializeWellKnownContext, showDenyOverlay };