@native-marketing/sdk 0.3.6 → 0.3.8

package/package.json

@@ -1,11 +1,21 @@
 {
   "name": "@native-marketing/sdk",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "type": "module",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=24 <25"
   },
+  "nativeMarketing": {
+    "contractVersion": 1,
+    "apiMajor": 1,
+    "nodeMajor": 24,
+    "changes": [
+      "Unified typed human interaction cards and authenticated reading links across SDK, CLI and MCP.",
+      "Explicitly authorized expiring public read-only package text snapshots with original request recovery and revocation.",
+      "Bound human presentation responses to the configured Project, original issuance request and source version."
+    ]
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"

package/release.json

@@ -1,7 +1,7 @@
 {
-  "sourceCommit": "40463e01d4112b05570b24ec7da538ed5f489d0d",
+  "sourceCommit": "5d24ed0dd6a4464dfc7dbe20275c546919268f25",
   "workingTreeDirty": false,
-  "version": "0.3.6",
-  "openapiTypesSha256": "e79e0abf034cae01174e67464aea55f16d40895c86199eff93897ec892ea82f4",
+  "version": "0.3.8",
+  "openapiTypesSha256": "ad906135a3c4706a888cb1cbb411d7b032c42120fcd13f5468e748a7f8db6651",
   "localBuild": true
 }

package/types/contracts/access/permission.d.ts

@@ -32,6 +32,7 @@ export declare const permissionSchema: z.ZodEnum<{
     "package.review": "package.review";
     "permissions.manage": "permissions.manage";
     "personal-context.read": "personal-context.read";
+    "presentation.share": "presentation.share";
     "project-representation.manage": "project-representation.manage";
     "project-representation.read": "project-representation.read";
     "project-survey.read": "project-survey.read";
@@ -90,6 +91,7 @@ export declare const permissionGrantSchema: z.ZodObject<{
         "package.review": "package.review";
         "permissions.manage": "permissions.manage";
         "personal-context.read": "personal-context.read";
+        "presentation.share": "presentation.share";
         "project-representation.manage": "project-representation.manage";
         "project-representation.read": "project-representation.read";
         "project-survey.read": "project-survey.read";
@@ -152,6 +154,7 @@ export declare const createPermissionGrantInputSchema: z.ZodObject<{
         "package.review": "package.review";
         "permissions.manage": "permissions.manage";
         "personal-context.read": "personal-context.read";
+        "presentation.share": "presentation.share";
         "project-representation.manage": "project-representation.manage";
         "project-representation.read": "project-representation.read";
         "project-survey.read": "project-survey.read";

package/types/contracts/access/project-access.d.ts

@@ -52,6 +52,7 @@ export declare const projectAccessViewSchema: z.ZodObject<{
         "package.review": "package.review";
         "permissions.manage": "permissions.manage";
         "personal-context.read": "personal-context.read";
+        "presentation.share": "presentation.share";
         "project-representation.manage": "project-representation.manage";
         "project-representation.read": "project-representation.read";
         "project-survey.read": "project-survey.read";
@@ -102,6 +103,7 @@ export declare const projectAccessViewSchema: z.ZodObject<{
         "package.review": "package.review";
         "permissions.manage": "permissions.manage";
         "personal-context.read": "personal-context.read";
+        "presentation.share": "presentation.share";
         "project-representation.manage": "project-representation.manage";
         "project-representation.read": "project-representation.read";
         "project-survey.read": "project-survey.read";

package/types/contracts/agent/human-presentation-validation.d.ts

@@ -0,0 +1,4 @@
+import type { HumanPresentation } from './human-presentation.js';
+/** Bind externally returned URLs to the configured product and exact Project. */
+export declare function validateHumanPresentationResource(human: HumanPresentation, resource: string, packageCode?: string): boolean;
+export declare function validateHumanPresentationResponse(parsed: Record<string, unknown>, resource: string, input: Record<string, unknown>, operation: string): boolean;

package/types/contracts/agent/human-presentation.d.ts

@@ -0,0 +1,300 @@
+import { z } from 'zod';
+export declare const humanPresentationCapability = "com.native-marketing/human-presentation";
+export declare const humanPresentationFeatures: Readonly<{
+    version: 1;
+    subjects: string[];
+    interactions: string[];
+    links: string[];
+    publicRead: "SNAPSHOT";
+}>;
+export declare const humanPresentationInputSchema: z.ZodObject<{
+    packageCode: z.ZodString;
+}, z.core.$strict>;
+export declare const humanReadLinkSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    linkRef: z.ZodString;
+    kind: z.ZodLiteral<"READABLE_CONTENT">;
+    title: z.ZodString;
+    subjectRef: z.ZodString;
+    url: z.ZodString;
+    access: z.ZodLiteral<"AUTHENTICATED">;
+    representation: z.ZodLiteral<"CURRENT_VIEW">;
+    expiresAt: z.ZodNull;
+}, z.core.$strict>, z.ZodObject<{
+    linkRef: z.ZodString;
+    kind: z.ZodLiteral<"READABLE_CONTENT">;
+    title: z.ZodString;
+    subjectRef: z.ZodString;
+    url: z.ZodString;
+    access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+    representation: z.ZodLiteral<"SNAPSHOT">;
+    snapshotRef: z.ZodString;
+    contentSha256: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strict>], "access">;
+export declare const humanInteractionSchema: z.ZodObject<{
+    interactionRef: z.ZodString;
+    kind: z.ZodLiteral<"CONTENT_PACKAGE_REVIEW">;
+    subjectRef: z.ZodString;
+    title: z.ZodString;
+    summary: z.ZodString;
+    state: z.ZodEnum<{
+        APPROVED: "APPROVED";
+        PENDING: "PENDING";
+        REJECTED: "REJECTED";
+        RESOLVED: "RESOLVED";
+    }>;
+    sourceState: z.ZodString;
+    actionDigest: z.ZodString;
+    expiresAt: z.ZodNull;
+    reviewUrl: z.ZodString;
+    canReview: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const humanPresentationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    interactions: z.ZodArray<z.ZodObject<{
+        interactionRef: z.ZodString;
+        kind: z.ZodLiteral<"CONTENT_PACKAGE_REVIEW">;
+        subjectRef: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodString;
+        state: z.ZodEnum<{
+            APPROVED: "APPROVED";
+            PENDING: "PENDING";
+            REJECTED: "REJECTED";
+            RESOLVED: "RESOLVED";
+        }>;
+        sourceState: z.ZodString;
+        actionDigest: z.ZodString;
+        expiresAt: z.ZodNull;
+        reviewUrl: z.ZodString;
+        canReview: z.ZodBoolean;
+    }, z.core.$strict>>;
+    links: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        linkRef: z.ZodString;
+        kind: z.ZodLiteral<"READABLE_CONTENT">;
+        title: z.ZodString;
+        subjectRef: z.ZodString;
+        url: z.ZodString;
+        access: z.ZodLiteral<"AUTHENTICATED">;
+        representation: z.ZodLiteral<"CURRENT_VIEW">;
+        expiresAt: z.ZodNull;
+    }, z.core.$strict>, z.ZodObject<{
+        linkRef: z.ZodString;
+        kind: z.ZodLiteral<"READABLE_CONTENT">;
+        title: z.ZodString;
+        subjectRef: z.ZodString;
+        url: z.ZodString;
+        access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+        representation: z.ZodLiteral<"SNAPSHOT">;
+        snapshotRef: z.ZodString;
+        contentSha256: z.ZodString;
+        createdAt: z.ZodString;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>], "access">>;
+}, z.core.$strict>;
+export declare const humanReadableDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    title: z.ZodString;
+    subjectRef: z.ZodString;
+    manifestHash: z.ZodString;
+    sections: z.ZodArray<z.ZodObject<{
+        heading: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const issueHumanReadLinkInputSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    packageCode: z.ZodString;
+    expectedManifestHash: z.ZodString;
+    access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+    targetKeys: z.ZodArray<z.ZodString>;
+    ttlSeconds: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const humanReadLinkLookupSchema: z.ZodObject<{
+    linkRef: z.ZodString;
+}, z.core.$strict>;
+export declare const humanReadLinkReceiptQuerySchema: z.ZodObject<{
+    requestId: z.ZodString;
+}, z.core.$strict>;
+export declare const revokeHumanReadLinkInputSchema: z.ZodObject<{
+    linkRef: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strict>;
+export declare const humanReadLinkResultSchema: z.ZodObject<{
+    linkRef: z.ZodString;
+    issuanceRequestId: z.ZodString;
+    state: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        EXPIRED: "EXPIRED";
+        REVOKED: "REVOKED";
+        UNAVAILABLE: "UNAVAILABLE";
+    }>;
+    packageCode: z.ZodString;
+    manifestHash: z.ZodString;
+    expiresAt: z.ZodString;
+    human: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        interactions: z.ZodArray<z.ZodObject<{
+            interactionRef: z.ZodString;
+            kind: z.ZodLiteral<"CONTENT_PACKAGE_REVIEW">;
+            subjectRef: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            state: z.ZodEnum<{
+                APPROVED: "APPROVED";
+                PENDING: "PENDING";
+                REJECTED: "REJECTED";
+                RESOLVED: "RESOLVED";
+            }>;
+            sourceState: z.ZodString;
+            actionDigest: z.ZodString;
+            expiresAt: z.ZodNull;
+            reviewUrl: z.ZodString;
+            canReview: z.ZodBoolean;
+        }, z.core.$strict>>;
+        links: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            linkRef: z.ZodString;
+            kind: z.ZodLiteral<"READABLE_CONTENT">;
+            title: z.ZodString;
+            subjectRef: z.ZodString;
+            url: z.ZodString;
+            access: z.ZodLiteral<"AUTHENTICATED">;
+            representation: z.ZodLiteral<"CURRENT_VIEW">;
+            expiresAt: z.ZodNull;
+        }, z.core.$strict>, z.ZodObject<{
+            linkRef: z.ZodString;
+            kind: z.ZodLiteral<"READABLE_CONTENT">;
+            title: z.ZodString;
+            subjectRef: z.ZodString;
+            url: z.ZodString;
+            access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+            representation: z.ZodLiteral<"SNAPSHOT">;
+            snapshotRef: z.ZodString;
+            contentSha256: z.ZodString;
+            createdAt: z.ZodString;
+            expiresAt: z.ZodString;
+        }, z.core.$strict>], "access">>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const humanReadLinkReceiptSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"FOUND">;
+    receipt: z.ZodObject<{
+        linkRef: z.ZodString;
+        issuanceRequestId: z.ZodString;
+        state: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            EXPIRED: "EXPIRED";
+            REVOKED: "REVOKED";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        packageCode: z.ZodString;
+        manifestHash: z.ZodString;
+        expiresAt: z.ZodString;
+        human: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            interactions: z.ZodArray<z.ZodObject<{
+                interactionRef: z.ZodString;
+                kind: z.ZodLiteral<"CONTENT_PACKAGE_REVIEW">;
+                subjectRef: z.ZodString;
+                title: z.ZodString;
+                summary: z.ZodString;
+                state: z.ZodEnum<{
+                    APPROVED: "APPROVED";
+                    PENDING: "PENDING";
+                    REJECTED: "REJECTED";
+                    RESOLVED: "RESOLVED";
+                }>;
+                sourceState: z.ZodString;
+                actionDigest: z.ZodString;
+                expiresAt: z.ZodNull;
+                reviewUrl: z.ZodString;
+                canReview: z.ZodBoolean;
+            }, z.core.$strict>>;
+            links: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                linkRef: z.ZodString;
+                kind: z.ZodLiteral<"READABLE_CONTENT">;
+                title: z.ZodString;
+                subjectRef: z.ZodString;
+                url: z.ZodString;
+                access: z.ZodLiteral<"AUTHENTICATED">;
+                representation: z.ZodLiteral<"CURRENT_VIEW">;
+                expiresAt: z.ZodNull;
+            }, z.core.$strict>, z.ZodObject<{
+                linkRef: z.ZodString;
+                kind: z.ZodLiteral<"READABLE_CONTENT">;
+                title: z.ZodString;
+                subjectRef: z.ZodString;
+                url: z.ZodString;
+                access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+                representation: z.ZodLiteral<"SNAPSHOT">;
+                snapshotRef: z.ZodString;
+                contentSha256: z.ZodString;
+                createdAt: z.ZodString;
+                expiresAt: z.ZodString;
+            }, z.core.$strict>], "access">>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"NOT_FOUND">;
+}, z.core.$strict>], "status">;
+export type HumanPresentation = z.infer<typeof humanPresentationSchema>;
+export type HumanInteraction = z.infer<typeof humanInteractionSchema>;
+export type HumanReadLink = z.infer<typeof humanReadLinkSchema>;
+export type HumanReadableDocument = z.infer<typeof humanReadableDocumentSchema>;
+export type IssueHumanReadLinkInput = z.input<typeof issueHumanReadLinkInputSchema>;
+export type HumanPresentationContract<T> = z.ZodType<T>;
+export type HumanPresentationContractInput<T extends z.ZodType> = z.input<T>;
+export type HumanReadLinkResult = z.infer<typeof humanReadLinkResultSchema>;
+export declare const cleanupHumanReadLinksInputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const cleanupHumanReadLinksResultSchema: z.ZodObject<{
+    reclaimed: z.ZodNumber;
+    limit: z.ZodNumber;
+}, z.core.$strict>;
+export declare const humanPresentationResultSchema: z.ZodObject<{
+    human: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        interactions: z.ZodArray<z.ZodObject<{
+            interactionRef: z.ZodString;
+            kind: z.ZodLiteral<"CONTENT_PACKAGE_REVIEW">;
+            subjectRef: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            state: z.ZodEnum<{
+                APPROVED: "APPROVED";
+                PENDING: "PENDING";
+                REJECTED: "REJECTED";
+                RESOLVED: "RESOLVED";
+            }>;
+            sourceState: z.ZodString;
+            actionDigest: z.ZodString;
+            expiresAt: z.ZodNull;
+            reviewUrl: z.ZodString;
+            canReview: z.ZodBoolean;
+        }, z.core.$strict>>;
+        links: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            linkRef: z.ZodString;
+            kind: z.ZodLiteral<"READABLE_CONTENT">;
+            title: z.ZodString;
+            subjectRef: z.ZodString;
+            url: z.ZodString;
+            access: z.ZodLiteral<"AUTHENTICATED">;
+            representation: z.ZodLiteral<"CURRENT_VIEW">;
+            expiresAt: z.ZodNull;
+        }, z.core.$strict>, z.ZodObject<{
+            linkRef: z.ZodString;
+            kind: z.ZodLiteral<"READABLE_CONTENT">;
+            title: z.ZodString;
+            subjectRef: z.ZodString;
+            url: z.ZodString;
+            access: z.ZodLiteral<"TEMPORARY_PUBLIC_READ">;
+            representation: z.ZodLiteral<"SNAPSHOT">;
+            snapshotRef: z.ZodString;
+            contentSha256: z.ZodString;
+            createdAt: z.ZodString;
+            expiresAt: z.ZodString;
+        }, z.core.$strict>], "access">>;
+    }, z.core.$strict>;
+}, z.core.$strict>;

package/types/contracts/client-lifecycle.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export { nativeClientRelease } from './generated/client-release.js';
+export declare const nativeReleaseCapability = "com.native-marketing/client-release";
+export declare const releaseVersionSchema: z.ZodString;
+export declare const clientIdentitySchema: z.ZodObject<{
+    version: z.ZodString;
+    contractVersion: z.ZodNumber;
+    apiMajor: z.ZodNumber;
+}, z.core.$strip>;
+export declare const clientReleaseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    product: z.ZodLiteral<"native-marketing">;
+    version: z.ZodString;
+    packages: z.ZodObject<{
+        sdk: z.ZodLiteral<"@native-marketing/sdk">;
+        cli: z.ZodLiteral<"@native-marketing/cli">;
+    }, z.core.$strip>;
+    contractVersion: z.ZodNumber;
+    minimumClientVersion: z.ZodString;
+    apiMajor: z.ZodNumber;
+    nodeMajor: z.ZodNumber;
+    changes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const updatePolicySchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        notify: "notify";
+        off: "off";
+    }>>;
+    channel: z.ZodDefault<z.ZodEnum<{
+        beta: "beta";
+        latest: "latest";
+        next: "next";
+    }>>;
+    pin: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    intervalHours: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const defaultUpdatePolicy: {
+    mode: "auto" | "notify" | "off";
+    channel: "beta" | "latest" | "next";
+    pin: string | null;
+    intervalHours: number;
+};
+export type NativeClientIdentity = z.infer<typeof clientIdentitySchema>;
+export type NativeClientRelease = z.infer<typeof clientReleaseSchema>;
+export type NativeUpdatePolicy = z.infer<typeof updatePolicySchema>;
+export interface NativeCompatibility {
+    status: 'COMPATIBLE' | 'UPGRADE_RECOMMENDED' | 'INCOMPATIBLE' | 'UNKNOWN';
+    reason: 'CURRENT' | 'NEWER_CLIENT_AVAILABLE' | 'CLIENT_TOO_OLD' | 'CONTRACT_MISMATCH' | 'API_MISMATCH' | 'SERVER_METADATA_UNAVAILABLE';
+    client: NativeClientIdentity;
+    server: NativeClientRelease | null;
+}
+/** Exact SemVer precedence only; package-manager ranges are never interpreted here. */
+export declare function compareReleaseVersions(left: string, right: string): number;
+export declare function assessNativeCompatibility(client: NativeClientIdentity, server?: NativeClientRelease): NativeCompatibility;

package/types/contracts/client-update-policy.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { type NativeClientRelease, type NativeUpdatePolicy } from './client-lifecycle.js';
+export declare const registryReleaseSchema: z.ZodObject<{
+    name: z.ZodEnum<{
+        "@native-marketing/cli": "@native-marketing/cli";
+        "@native-marketing/sdk": "@native-marketing/sdk";
+    }>;
+    version: z.ZodString;
+    deprecated: z.ZodOptional<z.ZodString>;
+    nativeMarketing: z.ZodOptional<z.ZodObject<{
+        contractVersion: z.ZodNumber;
+        apiMajor: z.ZodNumber;
+        nodeMajor: z.ZodNumber;
+        changes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    dist: z.ZodObject<{
+        integrity: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type NativeRegistryRelease = z.infer<typeof registryReleaseSchema>;
+export declare const clientUpdateStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    policy: z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            notify: "notify";
+            off: "off";
+        }>>;
+        channel: z.ZodDefault<z.ZodEnum<{
+            beta: "beta";
+            latest: "latest";
+            next: "next";
+        }>>;
+        pin: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        intervalHours: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    lastCheck: z.ZodOptional<z.ZodObject<{
+        at: z.ZodNumber;
+        selector: z.ZodString;
+        target: z.ZodObject<{
+            name: z.ZodEnum<{
+                "@native-marketing/cli": "@native-marketing/cli";
+                "@native-marketing/sdk": "@native-marketing/sdk";
+            }>;
+            version: z.ZodString;
+            deprecated: z.ZodOptional<z.ZodString>;
+            nativeMarketing: z.ZodOptional<z.ZodObject<{
+                contractVersion: z.ZodNumber;
+                apiMajor: z.ZodNumber;
+                nodeMajor: z.ZodNumber;
+                changes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            dist: z.ZodObject<{
+                integrity: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strict>>;
+    lastAttempt: z.ZodOptional<z.ZodObject<{
+        at: z.ZodNumber;
+        selector: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type NativeClientUpdateState = z.infer<typeof clientUpdateStateSchema>;
+export interface NativeUpdatePlan {
+    package: NativeRegistryRelease['name'];
+    currentVersion: string;
+    targetVersion: string;
+    status: 'CURRENT' | 'UPDATE_AVAILABLE' | 'BLOCKED';
+    reason: 'CURRENT' | 'COMPATIBLE_UPDATE' | 'REVIEW_REQUIRED' | 'PIN_MISMATCH' | 'CHANNEL_MISMATCH' | 'DOWNGRADE_FORBIDDEN' | 'METADATA_UNAVAILABLE' | 'CONTRACT_MISMATCH' | 'NODE_MISMATCH' | 'SERVER_INCOMPATIBLE' | 'DEPRECATED';
+    eligibleForAutoUpdate: boolean;
+    policy: NativeUpdatePolicy;
+    commands: {
+        npm: string[];
+        pnpm: string[];
+        yarn: string[] | null;
+    };
+}
+export declare function planNativeUpdate(input: {
+    target: NativeRegistryRelease;
+    currentVersion?: string;
+    policy?: NativeUpdatePolicy;
+    nodeMajor?: number;
+    server?: NativeClientRelease;
+}): NativeUpdatePlan;

package/types/contracts/generated/client-release.d.ts

@@ -0,0 +1,14 @@
+export declare const nativeClientRelease: {
+    readonly schemaVersion: 1;
+    readonly product: 'native-marketing';
+    readonly version: '0.3.8';
+    readonly packages: {
+        readonly sdk: '@native-marketing/sdk';
+        readonly cli: '@native-marketing/cli';
+    };
+    readonly contractVersion: 1;
+    readonly minimumClientVersion: '0.3.6';
+    readonly apiMajor: 1;
+    readonly nodeMajor: 24;
+    readonly changes: readonly ['Unified typed human interaction cards and authenticated reading links across SDK, CLI and MCP.', 'Explicitly authorized expiring public read-only package text snapshots with original request recovery and revocation.', 'Bound human presentation responses to the configured Project, original issuance request and source version.'];
+};

package/types/contracts/index.d.ts

@@ -117,3 +117,7 @@ export * from './event-backlog.js';
 export * from './event-readiness.js';
 export * from './event-inbox.js';
 export * from './event-outbox-browser.js';
+export * from './client-lifecycle.js';
+export * from './client-update-policy.js';
+export * from './agent/human-presentation.js';
+export * from './agent/human-presentation-validation.js';

package/types/http/client-version.d.ts

@@ -0,0 +1,35 @@
+import type { ContentFactoryClientOptions } from './client.js';
+export declare function getNativeClientVersion(): {
+    schemaVersion: 1;
+    product: "native-marketing";
+    version: string;
+    packages: {
+        sdk: "@native-marketing/sdk";
+        cli: "@native-marketing/cli";
+    };
+    contractVersion: number;
+    minimumClientVersion: string;
+    apiMajor: number;
+    nodeMajor: number;
+    changes: string[];
+};
+export declare function checkNativeHttpVersion(options?: ContentFactoryClientOptions & {
+    timeoutMs?: number;
+    requireCompatibility?: boolean;
+}): Promise<{
+    client: {
+        schemaVersion: 1;
+        product: "native-marketing";
+        version: string;
+        packages: {
+            sdk: "@native-marketing/sdk";
+            cli: "@native-marketing/cli";
+        };
+        contractVersion: number;
+        minimumClientVersion: string;
+        apiMajor: number;
+        nodeMajor: number;
+        changes: string[];
+    };
+    compatibility: import("../contracts/index.js").NativeCompatibility;
+}>;

package/types/http/client.d.ts

@@ -2,6 +2,7 @@ import type { paths } from './generated/schema.js';
 export interface ContentFactoryClientOptions {
     baseUrl?: string;
     fetch?: (input: Request) => Promise<Response>;
+    compatibility?: 'check' | 'require';
 }
 /** 共用认证HTTP入口，空写动作与生产代理保持一致的JSON传输合同。 */
 export declare function createContentFactoryClient(options?: ContentFactoryClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;