@native-marketing/sdk 0.1.1 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@native-marketing/sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "license": "UNLICENSED",
   "engines": {

package/release.json

@@ -1,7 +1,7 @@
 {
-  "sourceCommit": "d5c864b995aaa63230e895df3d7cbe50d4947202",
+  "sourceCommit": "351676c470fe22c510ee38fe9c3e6032de241407",
   "workingTreeDirty": false,
-  "version": "0.1.1",
+  "version": "0.2.0",
   "openapiTypesSha256": "ab00b08c6f94b2b39d7f4010de2335d70be26e7987e9db6dc57fa308426aecc4",
   "localBuild": true
 }

package/types/contracts/agent/capabilities.d.ts

@@ -25,6 +25,7 @@ export declare const capabilityQuerySchema: z.ZodObject<{
     }>>;
     limit: z.ZodDefault<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodLiteral<"AGENT_V3">>;
 }, z.core.$strict>;
 export declare const capabilityDescribeSchema: z.ZodObject<{
     name: z.ZodString;
@@ -97,7 +98,65 @@ export declare const capabilityDefinitionSchema: z.ZodObject<{
         callsReauthorize: z.ZodLiteral<true>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const agentCapabilityPageSchema: z.ZodObject<{
+    catalogRevision: z.ZodString;
+    authority: z.ZodObject<{
+        discoveryIsAuthority: z.ZodLiteral<false>;
+        callsReauthorize: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+    page: z.ZodObject<{
+        hasMore: z.ZodBoolean;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<3>;
+    matching: z.ZodLiteral<"ACTION_OBJECT_BILINGUAL">;
+    result: z.ZodEnum<{
+        BROWSE: "BROWSE";
+        MATCH: "MATCH";
+        NO_MATCH: "NO_MATCH";
+    }>;
+    scope: z.ZodLiteral<"CURRENT_AUTHORIZED_CATALOGUE">;
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodString;
+        group: z.ZodEnum<{
+            administration: "administration";
+            delivery: "delivery";
+            foundation: "foundation";
+            knowledge: "knowledge";
+            operating: "operating";
+            review: "review";
+            strategy: "strategy";
+            system: "system";
+            tasks: "tasks";
+        }>;
+        readOnlyHint: z.ZodNullable<z.ZodBoolean>;
+        requiresHumanDecision: z.ZodBoolean;
+        businessStateChecked: z.ZodLiteral<false>;
+        schemaSha256: z.ZodOptional<z.ZodString>;
+        definition: z.ZodOptional<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            schemaSha256: z.ZodString;
+            definition: z.ZodObject<{
+                name: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>;
+            authority: z.ZodObject<{
+                discoveryIsAuthority: z.ZodLiteral<false>;
+                callsReauthorize: z.ZodLiteral<true>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        supportsValidateOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export type CapabilityQuery = z.infer<typeof capabilityQuerySchema>;
 export type CapabilitySummary = z.infer<typeof capabilitySummarySchema>;
 export type CapabilityPage = z.infer<typeof capabilityPageSchema>;
 export type CapabilityDefinition = z.infer<typeof capabilityDefinitionSchema>;
+export type AgentCapabilityPage = z.infer<typeof agentCapabilityPageSchema>;

package/types/contracts/agent/index.d.ts

@@ -33,7 +33,11 @@ export * from './execution/index.js';
 export * from './guidance.js';
 export * from './read-receipt.js';
 export * from './capabilities.js';
+export * from './input-repair.js';
 export * from './capability-outcome.js';
 export * from './business-search.js';
 export * from './compact-surface.js';
 export * from './document-page.js';
+export * from './test-records.js';
+export * from './validation.js';
+export * from './publication-preflight.js';

package/types/contracts/agent/input-repair.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const capabilityInputRepairSchema: z.ZodObject<{
+    phase: z.ZodLiteral<"INPUT">;
+    handlerEntered: z.ZodLiteral<false>;
+    issues: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        message: z.ZodLiteral<"Value does not match the declared schema.">;
+        expectedType: z.ZodOptional<z.ZodEnum<{
+            array: "array";
+            boolean: "boolean";
+            integer: "integer";
+            null: "null";
+            number: "number";
+            object: "object";
+            string: "string";
+        }>>;
+        allowedRange: z.ZodOptional<z.ZodObject<{
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strict>>;
+    argumentPatch: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+    schema: z.ZodObject<{
+        tool: z.ZodLiteral<"cf_describe_capability">;
+        arguments: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;

package/types/contracts/agent/publication-preflight.d.ts

@@ -0,0 +1,6 @@
+export declare const publicationPreflightSchema: import("zod").ZodObject<{
+    packageCode: import("zod").ZodOptional<import("zod").ZodString>;
+    targetKey: import("zod").ZodOptional<import("zod").ZodString>;
+    destinationCode: import("zod").ZodOptional<import("zod").ZodString>;
+    programCode: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;

package/types/contracts/agent/test-records.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const testRecordSaveSchema: z.ZodObject<{
+    recordId: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    label: z.ZodString;
+    payload: z.ZodString;
+    requestId: z.ZodString;
+    validateOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const testRecordReadSchema: z.ZodObject<{
+    recordId: z.ZodString;
+}, z.core.$strict>;
+export declare const testRecordCleanupSchema: z.ZodObject<{
+    records: z.ZodArray<z.ZodObject<{
+        recordId: z.ZodString;
+        expectedVersion: z.ZodNumber;
+    }, z.core.$strict>>;
+    requestId: z.ZodString;
+    validateOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const testRecordReceiptSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        CLEANUP: "CLEANUP";
+        SAVE: "SAVE";
+    }>;
+    requestId: z.ZodString;
+}, z.core.$strict>;
+export declare const testRecordRejectionCodes: readonly ['MCP_TEST_RECORD_CONFLICT', 'MCP_TEST_RECORD_NOT_FOUND', 'MCP_TEST_RECORD_CLEANED', 'IDEMPOTENCY_CONFLICT'];

package/types/contracts/agent/validation.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const capabilityValidationSchema: z.ZodObject<{
+    name: z.ZodString;
+    expectedSchemaSha256: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    validateOnly: z.ZodDefault<z.ZodLiteral<true>>;
+}, z.core.$strict>;

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';