@agentronics/sdk 0.6.0 → 0.7.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import * as _agentronics_protocol from '@agentronics/protocol';
-import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
-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';
+import { AgentIdentity, TraceEvent, PolicyRule, TrustLevel, SiteMemory } from '@agentronics/protocol';
+import { T as TraceExporter, G as GovernedTool, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-s9E9bVC0.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, z as ReviewRequest, B as Reviewer, S as SiteMemoryListener, E as SiteMemoryStore, F as SurfacingContext, H as SurfacingDecision, J as TokenBudgetReport, K as ToolGroupSummary, L as ToolRegistry, N as ToolTokenEstimate, O as TraceInput, Q as Tracer, V as VisionDetector, U as VisionDetectorOptions, W as VisionSignals, X as WebMcpAdapter, Y as WebMcpAdapterOptions, Z as WebMcpProvider, _ as WebMcpPublishResult, $ as WebMcpRegistration, a0 as WebMcpToolDescriptor, a1 as bundledDetectors, a2 as createAgentContextStore, a3 as createAuthEngine, a4 as createDetectorRegistry, a5 as createIdentityStore, a6 as createMemoryCache, a7 as createMemoryStore, a8 as createPolicyCache, a9 as createPolicyEngine, aa as createProgressionStore, ab as createRateLimiter, ac as createReviewPrompt, ad as createSiteMemoryStore, ae as createToolRegistry, af as createTracer, ag as createVisionDetector, ah as createWebMcpAdapter, ai as decideSurfacing, aj as defaultAuthMethods, ak as descriptorTokens, al as detectAgent, am as detectCrawler, an as detectDom, ao as estimateBudget, ap as estimateToolTokens, aq as explainSurfacing, ar as groupTools, as as init, at as listGroupNames, au as modelFacingDescriptor, av as previewAuthMethods, aw as scoreVisionSignals, ax as surfaceTools } from './init-only-s9E9bVC0.cjs';
+export { D as DetectWebMcpOptions, M as ModelContextTool, T as ToolAnnotations, W as WebMcpActivity, d as detectWebMcp, o as onWebMcpActivity, r as resolveModelContext, w as webMcpSupport } from './webmcp-BgKzHeQ3.cjs';
 
 interface DeclareAgentInput {
     class: 'webmcp' | 'dom' | 'screenshot' | 'crawler';
@@ -20,9 +20,11 @@ interface DetectorSignature {
 }
 interface SignatureLoaderOptions {
     gatewayUrl: string;
+    /** Your publishable key — the Agentronics API requires it. */
+    publishableKey?: string;
     fetcher?: typeof fetch;
 }
-declare const createSignatureLoader: ({ gatewayUrl, fetcher }: SignatureLoaderOptions) => {
+declare const createSignatureLoader: ({ gatewayUrl, publishableKey, fetcher }: SignatureLoaderOptions) => {
     snapshot(): DetectorSignature[];
     sync(): Promise<DetectorSignature[]>;
 };
@@ -40,8 +42,25 @@ interface GatewayExporterOptions {
     gatewayUrl: string;
     publishableKey: string;
     fetcher?: typeof fetch;
+    /** Send queued events this often (ms). Default 2000. */
+    flushMs?: number;
+    /** Events per request; the API accepts at most 100. Default 50. */
+    maxBatch?: number;
+    /** Events kept while the API is unreachable; the oldest are dropped first. Default 500. */
+    maxQueue?: number;
 }
-declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, }: GatewayExporterOptions) => TraceExporter;
+interface GatewayExporter extends TraceExporter {
+    /** Send everything queued now (`keepalive` lets it outlive the page); settles when the requests do. */
+    flush(keepalive?: boolean): Promise<void>;
+}
+/**
+ * Sends traces to the Agentronics API from the browser. Events are queued and
+ * sent in batches — every couple of seconds, when a batch fills, and when the
+ * page is hidden or closed — rather than one request per event, so a busy page
+ * stays within the API's per-visitor rate limit. Never throws into the page:
+ * a failed send drops that batch.
+ */
+declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, flushMs, maxBatch, maxQueue, }: GatewayExporterOptions) => GatewayExporter;
 
 interface WebhookExporterOptions {
     url: string;
@@ -51,6 +70,13 @@ interface WebhookExporterOptions {
 }
 declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }: WebhookExporterOptions) => TraceExporter;
 
+/** Mirrors ApiKeyIdentity in @agentronics/sdk/server (kept structural to avoid a server import). */
+interface ApiKeyIdentity {
+    agentId: string;
+    name?: string;
+    vendor?: string;
+    scopes?: string[];
+}
 interface IntelExporterOptions {
     /**
      * Agentronics API base URL (shown in the console under Settings) — the
@@ -95,6 +121,28 @@ interface IntelSync {
     pushTools(tools: GovernedTool[]): Promise<number>;
     /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
     pushMemory(snapshot: object, score?: number): Promise<void>;
+    /**
+     * Fetch what the console manages for this site: authorization rules and the
+     * tool descriptions you approved in Procedural memory. Pass them to the
+     * browser SDK — `init({ policies, toolDescriptions })`.
+     */
+    pullConfig(): Promise<DashboardConfig>;
+    /**
+     * An agent-API-key verifier for `createAgentAuth({ apiKey: { verify } })`
+     * that checks keys minted in the console, live — revoking a key in the
+     * console takes effect within `cacheSeconds` (default 60).
+     */
+    keyVerifier(options?: {
+        cacheSeconds?: number;
+    }): (key: string) => Promise<ApiKeyIdentity | null>;
+}
+interface DashboardConfig {
+    policies: PolicyRule[];
+    /** tool name → approved description (replaces the code's description when published). */
+    toolDescriptions: Record<string, string>;
+    /** The site-memory snapshot last pushed for this site (null if none). */
+    siteMemory: Record<string, unknown> | null;
+    fetchedAt: string;
 }
 /** @deprecated Use createDashboardSync (same function). */
 declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
@@ -188,11 +236,12 @@ interface ServeWellKnownOptions {
  */
 declare const serializeWellKnownContext: ({ snapshot }: ServeWellKnownOptions) => string;
 
+declare const SDK_VERSION = "0.1.2";
+
 declare const Agentronics: {
     init: (options: InitOptions) => AgentronicsClient;
     declareAgent: (input: DeclareAgentInput) => _agentronics_protocol.AgentIdentity;
     detectAgent: (options?: DetectAgentOptions) => Promise<_agentronics_protocol.AgentIdentity | null>;
 };
-declare const VERSION = "0.1.0";
 
-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 };
+export { Agentronics, AgentronicsClient, type DashboardConfig, type DeclareAgentInput, DetectAgentOptions, GovernedTool, InitOptions, type IntelExporterOptions, type IntelSync, type IntelSyncOptions, PolicyEngine, TraceExporter, SDK_VERSION as 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,8 +1,8 @@
 import * as _agentronics_protocol from '@agentronics/protocol';
-import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
-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';
+import { AgentIdentity, TraceEvent, PolicyRule, TrustLevel, SiteMemory } from '@agentronics/protocol';
+import { T as TraceExporter, G as GovernedTool, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-C80qhujz.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, z as ReviewRequest, B as Reviewer, S as SiteMemoryListener, E as SiteMemoryStore, F as SurfacingContext, H as SurfacingDecision, J as TokenBudgetReport, K as ToolGroupSummary, L as ToolRegistry, N as ToolTokenEstimate, O as TraceInput, Q as Tracer, V as VisionDetector, U as VisionDetectorOptions, W as VisionSignals, X as WebMcpAdapter, Y as WebMcpAdapterOptions, Z as WebMcpProvider, _ as WebMcpPublishResult, $ as WebMcpRegistration, a0 as WebMcpToolDescriptor, a1 as bundledDetectors, a2 as createAgentContextStore, a3 as createAuthEngine, a4 as createDetectorRegistry, a5 as createIdentityStore, a6 as createMemoryCache, a7 as createMemoryStore, a8 as createPolicyCache, a9 as createPolicyEngine, aa as createProgressionStore, ab as createRateLimiter, ac as createReviewPrompt, ad as createSiteMemoryStore, ae as createToolRegistry, af as createTracer, ag as createVisionDetector, ah as createWebMcpAdapter, ai as decideSurfacing, aj as defaultAuthMethods, ak as descriptorTokens, al as detectAgent, am as detectCrawler, an as detectDom, ao as estimateBudget, ap as estimateToolTokens, aq as explainSurfacing, ar as groupTools, as as init, at as listGroupNames, au as modelFacingDescriptor, av as previewAuthMethods, aw as scoreVisionSignals, ax as surfaceTools } from './init-only-C80qhujz.js';
+export { D as DetectWebMcpOptions, M as ModelContextTool, T as ToolAnnotations, W as WebMcpActivity, d as detectWebMcp, o as onWebMcpActivity, r as resolveModelContext, w as webMcpSupport } from './webmcp-BgKzHeQ3.js';
 
 interface DeclareAgentInput {
     class: 'webmcp' | 'dom' | 'screenshot' | 'crawler';
@@ -20,9 +20,11 @@ interface DetectorSignature {
 }
 interface SignatureLoaderOptions {
     gatewayUrl: string;
+    /** Your publishable key — the Agentronics API requires it. */
+    publishableKey?: string;
     fetcher?: typeof fetch;
 }
-declare const createSignatureLoader: ({ gatewayUrl, fetcher }: SignatureLoaderOptions) => {
+declare const createSignatureLoader: ({ gatewayUrl, publishableKey, fetcher }: SignatureLoaderOptions) => {
     snapshot(): DetectorSignature[];
     sync(): Promise<DetectorSignature[]>;
 };
@@ -40,8 +42,25 @@ interface GatewayExporterOptions {
     gatewayUrl: string;
     publishableKey: string;
     fetcher?: typeof fetch;
+    /** Send queued events this often (ms). Default 2000. */
+    flushMs?: number;
+    /** Events per request; the API accepts at most 100. Default 50. */
+    maxBatch?: number;
+    /** Events kept while the API is unreachable; the oldest are dropped first. Default 500. */
+    maxQueue?: number;
 }
-declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, }: GatewayExporterOptions) => TraceExporter;
+interface GatewayExporter extends TraceExporter {
+    /** Send everything queued now (`keepalive` lets it outlive the page); settles when the requests do. */
+    flush(keepalive?: boolean): Promise<void>;
+}
+/**
+ * Sends traces to the Agentronics API from the browser. Events are queued and
+ * sent in batches — every couple of seconds, when a batch fills, and when the
+ * page is hidden or closed — rather than one request per event, so a busy page
+ * stays within the API's per-visitor rate limit. Never throws into the page:
+ * a failed send drops that batch.
+ */
+declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, flushMs, maxBatch, maxQueue, }: GatewayExporterOptions) => GatewayExporter;
 
 interface WebhookExporterOptions {
     url: string;
@@ -51,6 +70,13 @@ interface WebhookExporterOptions {
 }
 declare const createWebhookExporter: ({ url, fetcher, maxRetries, queueLimit, }: WebhookExporterOptions) => TraceExporter;
 
+/** Mirrors ApiKeyIdentity in @agentronics/sdk/server (kept structural to avoid a server import). */
+interface ApiKeyIdentity {
+    agentId: string;
+    name?: string;
+    vendor?: string;
+    scopes?: string[];
+}
 interface IntelExporterOptions {
     /**
      * Agentronics API base URL (shown in the console under Settings) — the
@@ -95,6 +121,28 @@ interface IntelSync {
     pushTools(tools: GovernedTool[]): Promise<number>;
     /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
     pushMemory(snapshot: object, score?: number): Promise<void>;
+    /**
+     * Fetch what the console manages for this site: authorization rules and the
+     * tool descriptions you approved in Procedural memory. Pass them to the
+     * browser SDK — `init({ policies, toolDescriptions })`.
+     */
+    pullConfig(): Promise<DashboardConfig>;
+    /**
+     * An agent-API-key verifier for `createAgentAuth({ apiKey: { verify } })`
+     * that checks keys minted in the console, live — revoking a key in the
+     * console takes effect within `cacheSeconds` (default 60).
+     */
+    keyVerifier(options?: {
+        cacheSeconds?: number;
+    }): (key: string) => Promise<ApiKeyIdentity | null>;
+}
+interface DashboardConfig {
+    policies: PolicyRule[];
+    /** tool name → approved description (replaces the code's description when published). */
+    toolDescriptions: Record<string, string>;
+    /** The site-memory snapshot last pushed for this site (null if none). */
+    siteMemory: Record<string, unknown> | null;
+    fetchedAt: string;
 }
 /** @deprecated Use createDashboardSync (same function). */
 declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
@@ -188,11 +236,12 @@ interface ServeWellKnownOptions {
  */
 declare const serializeWellKnownContext: ({ snapshot }: ServeWellKnownOptions) => string;
 
+declare const SDK_VERSION = "0.1.2";
+
 declare const Agentronics: {
     init: (options: InitOptions) => AgentronicsClient;
     declareAgent: (input: DeclareAgentInput) => _agentronics_protocol.AgentIdentity;
     detectAgent: (options?: DetectAgentOptions) => Promise<_agentronics_protocol.AgentIdentity | null>;
 };
-declare const VERSION = "0.1.0";
 
-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 };
+export { Agentronics, AgentronicsClient, type DashboardConfig, type DeclareAgentInput, DetectAgentOptions, GovernedTool, InitOptions, type IntelExporterOptions, type IntelSync, type IntelSyncOptions, PolicyEngine, TraceExporter, SDK_VERSION as 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 };