@agentronics/sdk 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,7 +1,7 @@
1
1
  import * as _agentronics_protocol from '@agentronics/protocol';
2
2
  import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
3
- import { T as TraceExporter, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-Cwll8MGz.cjs';
4
- 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';
3
+ import { T as TraceExporter, G as GovernedTool, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-Cwll8MGz.cjs';
4
+ 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';
5
5
  export { D as DetectWebMcpOptions, d as detectWebMcp } from './webmcp-C4ikhM4g.cjs';
6
6
 
7
7
  interface DeclareAgentInput {
@@ -73,6 +73,28 @@ interface IntelExporterOptions {
73
73
  * and can't send an auth header).
74
74
  */
75
75
  declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
76
+ interface IntelSyncOptions {
77
+ /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
78
+ url: string;
79
+ /** Per-tenant SDK ingest key (`agtx_ik_…`). Backend-only — never the browser. */
80
+ ingestKey: string;
81
+ /** The site these tools/memory belong to (matches your SDK `siteId`). */
82
+ siteId: string;
83
+ fetcher?: typeof fetch;
84
+ }
85
+ /**
86
+ * Push the authoritative tool registry + site-memory snapshot to the
87
+ * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
88
+ * which is too large for the lightweight trace stream. Call after `syncTools()`
89
+ * / `provideSiteMemory(...)`. Backend/server use only (the key is secret).
90
+ */
91
+ interface IntelSync {
92
+ /** POST the registry to /v1/sdk/tools. Returns the number of tools sent. */
93
+ pushTools(tools: GovernedTool[]): Promise<number>;
94
+ /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
95
+ pushMemory(snapshot: object, score?: number): Promise<void>;
96
+ }
97
+ declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
76
98
 
77
99
  interface TrustDerivationInput {
78
100
  detected?: boolean;
@@ -166,4 +188,4 @@ declare const Agentronics: {
166
188
  };
167
189
  declare const VERSION = "0.1.0";
168
190
 
169
- 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 };
191
+ 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 CHANGED
@@ -1,7 +1,7 @@
1
1
  import * as _agentronics_protocol from '@agentronics/protocol';
2
2
  import { AgentIdentity, TraceEvent, TrustLevel, SiteMemory } from '@agentronics/protocol';
3
- import { T as TraceExporter, P as PolicyEngine, I as InitOptions, A as AgentronicsClient, D as DetectAgentOptions } from './init-only-7f8_LQAI.js';
4
- 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';
3
+ 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';
4
+ 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';
5
5
  export { D as DetectWebMcpOptions, d as detectWebMcp } from './webmcp-C4ikhM4g.js';
6
6
 
7
7
  interface DeclareAgentInput {
@@ -73,6 +73,28 @@ interface IntelExporterOptions {
73
73
  * and can't send an auth header).
74
74
  */
75
75
  declare const createIntelExporter: ({ url, ingestKey, fetcher, }: IntelExporterOptions) => TraceExporter;
76
+ interface IntelSyncOptions {
77
+ /** Intelligence API base URL (e.g. `https://intel-api-….run.app`). */
78
+ url: string;
79
+ /** Per-tenant SDK ingest key (`agtx_ik_…`). Backend-only — never the browser. */
80
+ ingestKey: string;
81
+ /** The site these tools/memory belong to (matches your SDK `siteId`). */
82
+ siteId: string;
83
+ fetcher?: typeof fetch;
84
+ }
85
+ /**
86
+ * Push the authoritative tool registry + site-memory snapshot to the
87
+ * Intelligence dashboard — the full data the WebMCP Tools + Knaph pages need,
88
+ * which is too large for the lightweight trace stream. Call after `syncTools()`
89
+ * / `provideSiteMemory(...)`. Backend/server use only (the key is secret).
90
+ */
91
+ interface IntelSync {
92
+ /** POST the registry to /v1/sdk/tools. Returns the number of tools sent. */
93
+ pushTools(tools: GovernedTool[]): Promise<number>;
94
+ /** POST the site-memory snapshot (+ optional quality score) to /v1/sdk/memory. */
95
+ pushMemory(snapshot: object, score?: number): Promise<void>;
96
+ }
97
+ declare const createIntelSync: ({ url, ingestKey, siteId, fetcher, }: IntelSyncOptions) => IntelSync;
76
98
 
77
99
  interface TrustDerivationInput {
78
100
  detected?: boolean;
@@ -166,4 +188,4 @@ declare const Agentronics: {
166
188
  };
167
189
  declare const VERSION = "0.1.0";
168
190
 
169
- 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 };
191
+ 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 };