@native-marketing/sdk 0.3.5 → 0.3.7

package/types/http/generated/schema.d.ts

@@ -13326,6 +13326,8 @@ export interface paths {
               contentAvailable: boolean;
               projectBound: boolean | null;
               selected: boolean;
+              referenceRepairRequired?: boolean;
+              resourceLinked?: boolean;
               /** Format: uri */
               originalUrl: string | null;
               evidenceRefs: string[];
@@ -13491,6 +13493,8 @@ export interface paths {
               contentAvailable: boolean;
               projectBound: boolean | null;
               selected: boolean;
+              referenceRepairRequired?: boolean;
+              resourceLinked?: boolean;
               /** Format: uri */
               originalUrl: string | null;
               evidenceRefs: string[];
@@ -72738,6 +72742,645 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  '/tenants/{tenantCode}/knowledge/reference-repair/preview': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: {
+      parameters: {
+        query: {
+          sourceRef: string;
+        };
+        header?: never;
+        path: {
+          tenantCode: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Default Response */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              sourceRef: string;
+              remoteRef: string;
+              basisHash: string;
+              sourceTenantId: string;
+              item: {
+                ref: string;
+                ownerTenantId: string;
+                resourceType: string;
+                /** @enum {string} */
+                originType: 'LEGACY_PROJECT' | 'TENANT_AUTHOR' | 'TENANT_SOURCE';
+                identityHash: string;
+                /** @enum {string} */
+                identityKind: 'CAS_BYTES' | 'REFERENCE_RECORD_DIGEST';
+                kind: string;
+                classification: string;
+                mediaType: string;
+                title: string;
+                summary: string;
+                readable: boolean;
+                reasonCodes: string[];
+              };
+              byteLength: number;
+              /** @enum {boolean} */
+              verified: true;
+            };
+          };
+        };
+        /** @description Default Response */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        413: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        415: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/tenants/{tenantCode}/knowledge/reference-repair': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          tenantCode: string;
+        };
+        cookie?: never;
+      };
+      requestBody: {
+        content: {
+          'application/json': {
+            sourceRef: string;
+            requestId: string;
+            expectedBasisHash: string;
+          };
+        };
+      };
+      responses: {
+        /** @description Default Response */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              result: {
+                /** Format: uuid */
+                id: string;
+                ref: string;
+                /** Format: uuid */
+                tenantId: string;
+                /** @enum {string} */
+                sourceType:
+                  | 'KNOWLEDGE'
+                  | 'INSIGHT'
+                  | 'TREND'
+                  | 'HOT_TOPIC'
+                  | 'WORLD_FACT'
+                  | 'NEWS'
+                  | 'CASE_EVIDENCE'
+                  | 'HUMAN_IDEA'
+                  | 'EXTERNAL_REFERENCE';
+                sourceRef: string;
+                sourceAuthority: string;
+                /** Format: date-time */
+                observedAt: string | null;
+                /** Format: date-time */
+                validUntil: string | null;
+                evidenceRef: string | null;
+                snapshotHash: string | null;
+                metadata: {
+                  [key: string]: unknown;
+                };
+                /** Format: date-time */
+                createdAt: string;
+              };
+              replayed: boolean;
+            };
+          };
+        };
+        /** @description Default Response */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        413: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        415: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  '/tenants/{tenantCode}/knowledge/reference-repair/receipt': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get: {
+      parameters: {
+        query: {
+          requestId: string;
+        };
+        header?: never;
+        path: {
+          tenantCode: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Default Response */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json':
+              | {
+                  /** @enum {string} */
+                  state: 'FOUND';
+                  result: {
+                    /** Format: uuid */
+                    id: string;
+                    ref: string;
+                    /** Format: uuid */
+                    tenantId: string;
+                    /** @enum {string} */
+                    sourceType:
+                      | 'KNOWLEDGE'
+                      | 'INSIGHT'
+                      | 'TREND'
+                      | 'HOT_TOPIC'
+                      | 'WORLD_FACT'
+                      | 'NEWS'
+                      | 'CASE_EVIDENCE'
+                      | 'HUMAN_IDEA'
+                      | 'EXTERNAL_REFERENCE';
+                    sourceRef: string;
+                    sourceAuthority: string;
+                    /** Format: date-time */
+                    observedAt: string | null;
+                    /** Format: date-time */
+                    validUntil: string | null;
+                    evidenceRef: string | null;
+                    snapshotHash: string | null;
+                    metadata: {
+                      [key: string]: unknown;
+                    };
+                    /** Format: date-time */
+                    createdAt: string;
+                  };
+                }
+              | {
+                  /** @enum {string} */
+                  state: 'NOT_FOUND';
+                  /** @enum {string|null} */
+                  result: null;
+                }
+              | {
+                  /** @enum {string} */
+                  state: 'REJECTED';
+                  /** @enum {string|null} */
+                  result: null;
+                  error: {
+                    code: string;
+                    /** @enum {string} */
+                    outcome: 'REJECTED';
+                    recovery: string;
+                  };
+                };
+          };
+        };
+        /** @description Default Response */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        413: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        415: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        502: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+        /** @description Default Response */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            'application/json': {
+              error: {
+                code: string;
+                message: string;
+                requestId?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
 }
 export type webhooks = Record<string, never>;
 export interface components {

package/types/http/index.d.ts

@@ -1,4 +1,6 @@
 export { createContentFactoryClient } from './client.js';
+export { getNativeClientVersion, checkNativeHttpVersion } from './client-version.js';
+export { assessNativeCompatibility, planNativeUpdate, defaultUpdatePolicy, type NativeClientRelease, type NativeClientIdentity, type NativeRegistryRelease, type NativeCompatibility, type NativeUpdatePolicy, type NativeUpdatePlan, } from '../contracts/index.js';
 export { readingDocument } from '../contracts/index.js';
 export { programActivationRequirements } from '../contracts/index.js';
 export type { ProjectAccessView, ProjectAccessChange } from '../contracts/index.js';

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

@@ -3,6 +3,7 @@ export declare function verifyCapabilityDefinition(raw: unknown, name: string, e
 /** Per connection metadata only. A cache hit is never permission to execute. */
 export declare class CapabilityDefinitionCache {
     private readonly values;
+    clear(): void;
     remember(value: CapabilityDefinition): void;
     get(name: string, hash: string): {
         schemaVersion: 1;

package/types/sdk/cli/run.d.ts

@@ -2,6 +2,7 @@
 export declare function runNetworkCli(args: string[], env?: NodeJS.ProcessEnv, io?: {
     stdin?: AsyncIterable<string | Uint8Array>;
     notify?: (message: string) => void;
+    executablePath?: string;
 }, executable?: 'cf' | 'cf-agent'): Promise<{
     exitCode: number;
     envelope: {

package/types/sdk/client.d.ts

@@ -4,7 +4,10 @@ import { uploadNativeProjectMedia, uploadNativeMaterial, type NativeMaterialUplo
 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';
+import { readNativeServerVersion } from './updates/version.js';
 export interface NativeAgentClient {
+    getVersion(): ReturnType<typeof readNativeServerVersion>;
+    refreshVersion(): Promise<ReturnType<typeof readNativeServerVersion>>;
     readPackageFile(input: Parameters<typeof readNativePackageFile>[1]): ReturnType<typeof readNativePackageFile>;
     readProjectMediaFile(input: Parameters<typeof readNativeProjectMediaFile>[1]): ReturnType<typeof readNativeProjectMediaFile>;
     uploadProjectMedia(file: Parameters<typeof uploadNativeProjectMedia>[1]): ReturnType<typeof uploadNativeProjectMedia>;
@@ -32,4 +35,6 @@ export declare function withNativeAgentClient<T>(connection: {
     accessToken: string;
 }, action: (client: NativeAgentClient) => Promise<T>, options?: {
     timeoutMs?: number;
+    requireCompatibility?: boolean;
+    onVersion?: (version: ReturnType<typeof readNativeServerVersion>) => void;
 }): Promise<T>;

package/types/sdk/index.d.ts

@@ -17,3 +17,6 @@ export type { CapabilitySchemaRead, CapabilitySchemaPage } from '../contracts/in
 export { uploadNativeProjectMedia, uploadNativeMaterial, type NativeMaterialUpload, } from './material-upload.js';
 export { readNativeProjectMediaFile, projectMediaFileQuerySchema } from './project-media.js';
 export { readNativePackageFile } from './package-files.js';
+export { getNativeClientVersion } from './updates/version.js';
+export { checkNativeUpdates } from './updates/registry.js';
+export { assessNativeCompatibility, planNativeUpdate, defaultUpdatePolicy, type NativeClientRelease, type NativeClientIdentity, type NativeRegistryRelease, type NativeCompatibility, type NativeUpdatePolicy, type NativeUpdatePlan, } from '../contracts/index.js';