@agentronics/sdk 0.5.0 → 0.7.0

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[]>;
 };
@@ -51,9 +53,16 @@ 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 {
     /**
-     * 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,14 +76,16 @@ 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 {
-    /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
+    /** 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;
@@ -84,7 +95,7 @@ interface IntelSyncOptions {
 }
 /**
  * Push the authoritative tool registry + site-memory snapshot to the
- * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
+ * 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).
  */
@@ -93,8 +104,35 @@ 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;
+/** 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;
@@ -181,11 +219,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, 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[]>;
 };
@@ -51,9 +53,16 @@ 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 {
     /**
-     * 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,14 +76,16 @@ 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 {
-    /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
+    /** 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;
@@ -84,7 +95,7 @@ interface IntelSyncOptions {
 }
 /**
  * Push the authoritative tool registry + site-memory snapshot to the
- * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
+ * 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).
  */
@@ -93,8 +104,35 @@ 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;
+/** 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;
@@ -181,11 +219,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, 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 };