@native-marketing/sdk 0.1.1 → 0.3.0

package/types/sdk/agent-capabilities.d.ts

@@ -0,0 +1,3 @@
+import type { Client } from '@modelcontextprotocol/client';
+import { type CapabilityQuery, type AgentCapabilityPage } from '../contracts/index.js';
+export declare function findAgentCapabilities(client: Client, input?: Partial<CapabilityQuery>, timeout?: number): Promise<AgentCapabilityPage>;

package/types/sdk/capability-definition.d.ts

@@ -0,0 +1,24 @@
+import { type CapabilityDefinition } from '../contracts/index.js';
+export declare function verifyCapabilityDefinition(raw: unknown, name: string, expectedHash?: string): CapabilityDefinition;
+/** Per connection metadata only. A cache hit is never permission to execute. */
+export declare class CapabilityDefinitionCache {
+    private readonly values;
+    remember(value: CapabilityDefinition): void;
+    get(name: string, hash: string): {
+        schemaVersion: 1;
+        schemaSha256: string;
+        definition: {
+            name: string;
+            title?: string | undefined;
+            description?: string | undefined;
+            inputSchema: Record<string, unknown>;
+            outputSchema?: Record<string, unknown> | undefined;
+            annotations?: Record<string, unknown> | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        };
+        authority: {
+            discoveryIsAuthority: false;
+            callsReauthorize: true;
+        };
+    } | undefined;
+}

package/types/sdk/client.d.ts

@@ -1,7 +1,7 @@
 import { readNativePackageFile } from './package-files.js';
 import { readNativeProjectMediaFile } from './project-media.js';
 import { uploadNativeProjectMedia, uploadNativeMaterial, type NativeMaterialUpload } from './material-upload.js';
-import type { BusinessDocumentInput, AgentSummaryInput, AgentSummary, CapabilityCall, BusinessSearchQuery, BusinessSearchPage, BusinessContentPageRead, BusinessContentPage, CapabilityQuery, CapabilityPage, CapabilityDefinition, CapabilitySchemaRead, BusinessDocumentPage } from '../contracts/index.js';
+import type { BusinessDocumentInput, AgentSummaryInput, AgentSummary, CapabilityCall, BusinessSearchQuery, BusinessSearchPage, BusinessContentPageRead, BusinessContentPage, CapabilityQuery, CapabilityPage, AgentCapabilityPage, CapabilityDefinition, CapabilitySchemaRead, BusinessDocumentPage } from '../contracts/index.js';
 import { readNativeCapabilityDescriptor, readNativeCapabilitySchemaPage } from './schema-pages.js';
 import { inspectNativeTool, listNativeToolsPage, type NativeToolOptions, type NativeToolResult } from './operations.js';
 export interface NativeAgentClient {
@@ -24,7 +24,8 @@ export interface NativeAgentClient {
     searchBusiness(input?: Partial<BusinessSearchQuery>): Promise<BusinessSearchPage>;
     readBusinessPage(input: BusinessContentPageRead): Promise<BusinessContentPage>;
     findCapabilities(input?: Partial<CapabilityQuery>): Promise<CapabilityPage>;
-    describeCapability(name: string): Promise<CapabilityDefinition>;
+    discoverCapabilities(input?: Partial<CapabilityQuery>): Promise<AgentCapabilityPage>;
+    describeCapability(name: string, expectedSchemaSha256?: string): Promise<CapabilityDefinition>;
 }
 export declare function withNativeAgentClient<T>(connection: {
     resource: string;

package/types/sdk/index.d.ts

@@ -1,7 +1,8 @@
 export { withNativeAgentClient, type NativeAgentClient } from './client.js';
 export { runNetworkCli } from './cli/run.js';
+export { findAgentCapabilities } from './agent-capabilities.js';
 export { findNativeCapabilities, describeNativeCapability } from './capabilities.js';
-export type { CapabilityPage, CapabilityDefinition, CapabilityQuery, } from '../contracts/index.js';
+export type { CapabilityPage, AgentCapabilityPage, CapabilityDefinition, CapabilityQuery, } from '../contracts/index.js';
 export { CliError as NativeAgentClientError } from './errors.js';
 export { searchNativeBusiness, readNativeBusinessPage } from './business-search.js';
 export type { BusinessSearchQuery, BusinessSearchPage, BusinessContentPageRead, BusinessContentPage, } from '../contracts/index.js';