@sogni-ai/sogni-intelligence-client 2.1.0

package/dist/contracts/backboneDurableWorkflow.d.ts

@@ -0,0 +1,82 @@
+export declare const BACKBONE_SCHEMA_VERSION = "2026-04-27.1";
+export declare const BACKBONE_MODEL_KB_VERSION = "2026-04-27.2";
+export declare const BACKBONE_ROUTING_POLICY_VERSION = "2026-04-27.1";
+export declare const BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES: readonly ["generate_image", "generate_video", "generate_music", "edit_image", "apply_style", "restore_photo", "refine_result", "animate_photo", "change_angle", "video_to_video", "stitch_video", "orbit_video", "dance_montage", "sound_to_video", "extend_video", "replace_video_segment", "overlay_video", "add_subtitles", "analyze_image", "analyze_video", "extract_metadata", "ask_clarifying_question", "finalize_response", "create_asset_manifest", "inspect_asset", "label_asset", "map_assets_for_model", "validate_asset_references"];
+export type BackboneDurableHostedStepToolName = (typeof BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES)[number];
+export type BackboneWorkflowStatus = "queued" | "running" | "completed" | "partial_failure" | "waiting_for_user" | "failed" | "cancelled";
+export type BackboneWorkflowDependencyTransform = "artifact_url" | "artifact_data_uri" | "image_url" | "video_url" | "audio_url" | "image_index" | "video_index" | "audio_index" | "subtitle_cues" | "subtitle_srt" | "overlay_items" | "asset_ref";
+export interface BackboneWorkflowStepDependencyBinding {
+    sourceStepId: string;
+    targetArgument: string;
+    transform: BackboneWorkflowDependencyTransform;
+    sourceArtifactId?: string;
+    sourceArtifactIndex?: number;
+    mediaType?: "image" | "video" | "audio";
+    required?: boolean;
+}
+export interface BackboneDurableWorkflowPlanStep {
+    id: string;
+    sequence: number;
+    toolName: BackboneDurableHostedStepToolName;
+    arguments: Record<string, unknown>;
+    dependsOn?: BackboneWorkflowStepDependencyBinding[];
+}
+export interface BackboneVersionManifest {
+    schemaVersion: typeof BACKBONE_SCHEMA_VERSION;
+    modelKnowledgeVersion: typeof BACKBONE_MODEL_KB_VERSION;
+    routingPolicyVersion: typeof BACKBONE_ROUTING_POLICY_VERSION;
+}
+export interface BackboneDurableWorkflowRunContract {
+    workflowId: string;
+    status: BackboneWorkflowStatus;
+    backbone: BackboneVersionManifest;
+    title?: string;
+    input: Record<string, unknown>;
+    steps: BackboneDurableWorkflowPlanStep[];
+    events: unknown[];
+    artifacts: unknown[];
+    lease?: {
+        leaseId: string;
+        ownerId: string;
+        acquiredAt: string;
+        heartbeatAt: string;
+        expiresAt: string;
+    };
+    recovery?: {
+        resumeCount: number;
+        lastResumeAt?: string;
+        lastRecoveredAt?: string;
+        reason?: string;
+    };
+    quality?: {
+        postflightAudits?: unknown[];
+    };
+    timestamps: {
+        createdAt: string;
+        updatedAt: string;
+        completedAt?: string;
+    };
+}
+export interface BackboneDurableWorkflowStepInput {
+    id?: string;
+    toolName: BackboneDurableHostedStepToolName;
+    arguments: Record<string, unknown>;
+    dependsOn?: BackboneWorkflowStepDependencyBinding[];
+}
+export interface BackboneDurableWorkflowInput {
+    title?: string;
+    steps: BackboneDurableWorkflowStepInput[];
+    mediaReferences?: unknown[];
+}
+export declare const BACKBONE_VERSIONS: BackboneVersionManifest;
+export declare class BackboneWorkflowValidationError extends Error {
+    constructor(message: string);
+}
+export declare const MAX_HOSTED_TOOL_SEQUENCE_STEPS = 12;
+export declare function normalizeBackboneDurableWorkflowSteps(input: BackboneDurableWorkflowInput): BackboneDurableWorkflowPlanStep[];
+export declare function buildBackboneDurableWorkflowRun(input: BackboneDurableWorkflowInput, options: {
+    workflowId: string;
+    now?: string;
+    title?: string;
+}): BackboneDurableWorkflowRunContract;
+//# sourceMappingURL=backboneDurableWorkflow.d.ts.map

package/dist/contracts/backboneDurableWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backboneDurableWorkflow.d.ts","sourceRoot":"","sources":["../../src/contracts/backboneDurableWorkflow.ts"],"names":[],"mappings":"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"}

package/dist/contracts/backboneDurableWorkflow.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_HOSTED_TOOL_SEQUENCE_STEPS = exports.BackboneWorkflowValidationError = exports.BACKBONE_VERSIONS = exports.BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES = exports.BACKBONE_ROUTING_POLICY_VERSION = exports.BACKBONE_MODEL_KB_VERSION = exports.BACKBONE_SCHEMA_VERSION = void 0;
+exports.normalizeBackboneDurableWorkflowSteps = normalizeBackboneDurableWorkflowSteps;
+exports.buildBackboneDurableWorkflowRun = buildBackboneDurableWorkflowRun;
+const backboneToolCatalog_js_1 = require("./backboneToolCatalog.js");
+exports.BACKBONE_SCHEMA_VERSION = "2026-04-27.1";
+exports.BACKBONE_MODEL_KB_VERSION = "2026-04-27.2";
+exports.BACKBONE_ROUTING_POLICY_VERSION = "2026-04-27.1";
+exports.BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES = [
+    ...backboneToolCatalog_js_1.BACKBONE_DURABLE_HOSTED_CREATIVE_TOOL_NAMES,
+    ...backboneToolCatalog_js_1.BACKBONE_HOSTED_APP_TOOL_NAMES,
+];
+exports.BACKBONE_VERSIONS = {
+    schemaVersion: exports.BACKBONE_SCHEMA_VERSION,
+    modelKnowledgeVersion: exports.BACKBONE_MODEL_KB_VERSION,
+    routingPolicyVersion: exports.BACKBONE_ROUTING_POLICY_VERSION,
+};
+class BackboneWorkflowValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BackboneWorkflowValidationError";
+    }
+}
+exports.BackboneWorkflowValidationError = BackboneWorkflowValidationError;
+exports.MAX_HOSTED_TOOL_SEQUENCE_STEPS = 12;
+const HOSTED_TOOL_NAME_SET = new Set(exports.BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES);
+function safeStepId(value, fallback) {
+    const safe = value
+        .trim()
+        .replace(/[^A-Za-z0-9_-]/g, "_")
+        .replace(/_+/g, "_");
+    return safe.length > 0 ? safe : fallback;
+}
+function compactRecord(entries) {
+    return Object.fromEntries(Object.entries(entries).filter(([, value]) => value !== undefined));
+}
+function normalizeBackboneDurableWorkflowSteps(input) {
+    if (!Array.isArray(input.steps) || input.steps.length === 0) {
+        throw new BackboneWorkflowValidationError("Durable workflow requires at least one step");
+    }
+    if (input.steps.length > exports.MAX_HOSTED_TOOL_SEQUENCE_STEPS) {
+        throw new BackboneWorkflowValidationError(`Durable workflow supports at most ${exports.MAX_HOSTED_TOOL_SEQUENCE_STEPS} steps`);
+    }
+    const seenIds = new Set();
+    return input.steps.map((step, index) => {
+        if (!HOSTED_TOOL_NAME_SET.has(step.toolName)) {
+            throw new BackboneWorkflowValidationError(`Unsupported hosted tool: ${step.toolName}`);
+        }
+        if (!step.arguments ||
+            typeof step.arguments !== "object" ||
+            Array.isArray(step.arguments)) {
+            throw new BackboneWorkflowValidationError(`Workflow step ${index} requires object arguments`);
+        }
+        let id = safeStepId(step.id ?? step.toolName, `step_${index + 1}`);
+        if (seenIds.has(id)) {
+            id = `${id}_${index + 1}`;
+        }
+        seenIds.add(id);
+        return {
+            id,
+            sequence: index,
+            toolName: step.toolName,
+            arguments: step.arguments,
+            ...(step.dependsOn ? { dependsOn: step.dependsOn } : {}),
+        };
+    });
+}
+function buildBackboneDurableWorkflowRun(input, options) {
+    const now = options.now ?? new Date().toISOString();
+    const steps = normalizeBackboneDurableWorkflowSteps(input);
+    return {
+        workflowId: options.workflowId,
+        status: "queued",
+        backbone: exports.BACKBONE_VERSIONS,
+        title: options.title ?? input.title ?? "Durable creative workflow",
+        input: compactRecord({
+            title: input.title,
+            mediaReferences: input.mediaReferences,
+            steps: steps.map((step) => ({
+                id: step.id,
+                toolName: step.toolName,
+                arguments: step.arguments,
+                ...(step.dependsOn ? { dependsOn: step.dependsOn } : {}),
+            })),
+        }),
+        steps,
+        events: [],
+        artifacts: [],
+        timestamps: {
+            createdAt: now,
+            updatedAt: now,
+        },
+    };
+}
+//# sourceMappingURL=backboneDurableWorkflow.js.map

package/dist/contracts/backboneDurableWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backboneDurableWorkflow.js","sourceRoot":"","sources":["../../src/contracts/backboneDurableWorkflow.ts"],"names":[],"mappings":"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"}

package/dist/contracts/backboneToolCatalog.d.ts

@@ -0,0 +1,7 @@
+export declare const BACKBONE_GENERATION_TOOL_NAMES: readonly ["generate_image", "generate_video", "generate_music", "edit_image", "apply_style", "restore_photo", "refine_result", "animate_photo", "change_angle", "video_to_video", "stitch_video", "orbit_video", "dance_montage", "sound_to_video", "extend_video", "replace_video_segment", "overlay_video", "add_subtitles"];
+export declare const BACKBONE_APP_TOOL_NAMES: readonly ["manage_memory", "resolve_personas", "set_content_filter", "analyze_image", "analyze_video", "extract_metadata", "ask_clarifying_question", "finalize_response", "create_asset_manifest", "inspect_asset", "label_asset", "map_assets_for_model", "validate_asset_references"];
+export declare const BACKBONE_HOSTED_APP_TOOL_NAMES: readonly ["analyze_image", "analyze_video", "extract_metadata", "ask_clarifying_question", "finalize_response", "create_asset_manifest", "inspect_asset", "label_asset", "map_assets_for_model", "validate_asset_references"];
+export declare const BACKBONE_COMPOSITION_TOOL_NAMES: readonly ["enhance_prompt", "compose_lyrics", "compose_instrumental", "compose_script", "compose_workflow", "compose_workflow_template"];
+export declare const BACKBONE_DURABLE_HOSTED_CREATIVE_TOOL_NAMES: readonly ["generate_image", "generate_video", "generate_music", "edit_image", "apply_style", "restore_photo", "refine_result", "animate_photo", "change_angle", "video_to_video", "stitch_video", "orbit_video", "dance_montage", "sound_to_video", "extend_video", "replace_video_segment", "overlay_video", "add_subtitles"];
+export type BackboneAppToolName = (typeof BACKBONE_APP_TOOL_NAMES)[number];
+//# sourceMappingURL=backboneToolCatalog.d.ts.map

package/dist/contracts/backboneToolCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backboneToolCatalog.d.ts","sourceRoot":"","sources":["../../src/contracts/backboneToolCatalog.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,8BAA8B,gUAmBjC,CAAC;AAEX,eAAO,MAAM,uBAAuB,0RAc1B,CAAC;AAEX,eAAO,MAAM,8BAA8B,+NAWjC,CAAC;AAEX,eAAO,MAAM,+BAA+B,0IAOlC,CAAC;AAEX,eAAO,MAAM,2CAA2C,gUAE9C,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/contracts/backboneToolCatalog.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKBONE_DURABLE_HOSTED_CREATIVE_TOOL_NAMES = exports.BACKBONE_COMPOSITION_TOOL_NAMES = exports.BACKBONE_HOSTED_APP_TOOL_NAMES = exports.BACKBONE_APP_TOOL_NAMES = exports.BACKBONE_GENERATION_TOOL_NAMES = void 0;
+exports.BACKBONE_GENERATION_TOOL_NAMES = [
+    "generate_image",
+    "generate_video",
+    "generate_music",
+    "edit_image",
+    "apply_style",
+    "restore_photo",
+    "refine_result",
+    "animate_photo",
+    "change_angle",
+    "video_to_video",
+    "stitch_video",
+    "orbit_video",
+    "dance_montage",
+    "sound_to_video",
+    "extend_video",
+    "replace_video_segment",
+    "overlay_video",
+    "add_subtitles",
+];
+exports.BACKBONE_APP_TOOL_NAMES = [
+    "manage_memory",
+    "resolve_personas",
+    "set_content_filter",
+    "analyze_image",
+    "analyze_video",
+    "extract_metadata",
+    "ask_clarifying_question",
+    "finalize_response",
+    "create_asset_manifest",
+    "inspect_asset",
+    "label_asset",
+    "map_assets_for_model",
+    "validate_asset_references",
+];
+exports.BACKBONE_HOSTED_APP_TOOL_NAMES = [
+    "analyze_image",
+    "analyze_video",
+    "extract_metadata",
+    "ask_clarifying_question",
+    "finalize_response",
+    "create_asset_manifest",
+    "inspect_asset",
+    "label_asset",
+    "map_assets_for_model",
+    "validate_asset_references",
+];
+exports.BACKBONE_COMPOSITION_TOOL_NAMES = [
+    "enhance_prompt",
+    "compose_lyrics",
+    "compose_instrumental",
+    "compose_script",
+    "compose_workflow",
+    "compose_workflow_template",
+];
+exports.BACKBONE_DURABLE_HOSTED_CREATIVE_TOOL_NAMES = [
+    ...exports.BACKBONE_GENERATION_TOOL_NAMES,
+];
+//# sourceMappingURL=backboneToolCatalog.js.map

package/dist/contracts/backboneToolCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backboneToolCatalog.js","sourceRoot":"","sources":["../../src/contracts/backboneToolCatalog.ts"],"names":[],"mappings":";;;AAOa,QAAA,8BAA8B,GAAG;IAC5C,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,uBAAuB;IACvB,eAAe;IACf,eAAe;CACP,CAAC;AAEE,QAAA,uBAAuB,GAAG;IACrC,eAAe;IACf,kBAAkB;IAClB,oBAAoB;IACpB,eAAe;IACf,eAAe;IACf,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;IACnB,uBAAuB;IACvB,eAAe;IACf,aAAa;IACb,sBAAsB;IACtB,2BAA2B;CACnB,CAAC;AAEE,QAAA,8BAA8B,GAAG;IAC5C,eAAe;IACf,eAAe;IACf,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;IACnB,uBAAuB;IACvB,eAAe;IACf,aAAa;IACb,sBAAsB;IACtB,2BAA2B;CACnB,CAAC;AAEE,QAAA,+BAA+B,GAAG;IAC7C,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,2BAA2B;CACnB,CAAC;AAEE,QAAA,2CAA2C,GAAG;IACzD,GAAG,sCAA8B;CACzB,CAAC"}

package/dist/contracts/composeWorkflowTypes.d.ts

@@ -0,0 +1,6 @@
+export interface ComposeWorkflowDestinationModels {
+    image?: string;
+    video?: string;
+    music?: string;
+}
+//# sourceMappingURL=composeWorkflowTypes.d.ts.map

package/dist/contracts/composeWorkflowTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeWorkflowTypes.d.ts","sourceRoot":"","sources":["../../src/contracts/composeWorkflowTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/contracts/composeWorkflowTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=composeWorkflowTypes.js.map

package/dist/contracts/composeWorkflowTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeWorkflowTypes.js","sourceRoot":"","sources":["../../src/contracts/composeWorkflowTypes.ts"],"names":[],"mappings":""}

package/dist/contracts/data/costEstimation.d.ts

@@ -0,0 +1,5 @@
+import type { ToolCostClass } from './toolCostMetadata.js';
+export declare const COST_CLASS_NUMERIC_WEIGHTS: Readonly<Record<ToolCostClass, number>>;
+export declare const UNKNOWN_COST_CLASS_FALLBACK_WEIGHT = 1;
+export declare function getCostClassNumericWeight(costClass: ToolCostClass): number;
+//# sourceMappingURL=costEstimation.d.ts.map

package/dist/contracts/data/costEstimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costEstimation.d.ts","sourceRoot":"","sources":["../../../src/contracts/data/costEstimation.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAY9E,CAAC;AAQF,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAGpD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAE1E"}

package/dist/contracts/data/costEstimation.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_COST_CLASS_FALLBACK_WEIGHT = exports.COST_CLASS_NUMERIC_WEIGHTS = void 0;
+exports.getCostClassNumericWeight = getCostClassNumericWeight;
+exports.COST_CLASS_NUMERIC_WEIGHTS = {
+    'free': 0,
+    'image.standard': 1,
+    'image.premium': 2,
+    'image.external': 3,
+    'video.standard': 5,
+    'video.premium': 8,
+    'video.vendor.standard': 6,
+    'video.vendor.premium': 10,
+    'audio.standard': 3,
+    'compose.standard': 1,
+    'compose.ffmpeg': 1,
+};
+exports.UNKNOWN_COST_CLASS_FALLBACK_WEIGHT = 1;
+function getCostClassNumericWeight(costClass) {
+    return exports.COST_CLASS_NUMERIC_WEIGHTS[costClass];
+}
+//# sourceMappingURL=costEstimation.js.map

package/dist/contracts/data/costEstimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costEstimation.js","sourceRoot":"","sources":["../../../src/contracts/data/costEstimation.ts"],"names":[],"mappings":";;;AA2DA,8DAEC;AAzBY,QAAA,0BAA0B,GAA4C;IACjF,MAAM,EAAE,CAAC;IACT,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,sBAAsB,EAAE,EAAE;IAC1B,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,CAAC;IACrB,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAQW,QAAA,kCAAkC,GAAG,CAAC,CAAC;AAGpD,SAAgB,yBAAyB,CAAC,SAAwB;IAChE,OAAO,kCAA0B,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC"}

package/dist/contracts/data/gatingPolicies.d.ts

@@ -0,0 +1,6 @@
+import type { ContractRegistry } from '../registry.js';
+import type { ToolGatingPolicy } from '../toolGatingPolicy.js';
+export declare const MEDIA_TOOL_NAMES: ReadonlyArray<string>;
+export declare const GATING_POLICIES: ReadonlyArray<ToolGatingPolicy>;
+export declare function populateContractsGatingPolicies(registry: ContractRegistry): void;
+//# sourceMappingURL=gatingPolicies.d.ts.map

package/dist/contracts/data/gatingPolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatingPolicies.d.ts","sourceRoot":"","sources":["../../../src/contracts/data/gatingPolicies.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAW/D,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAmBlD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,gBAAgB,CAwM3D,CAAC;AAOF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAIhF"}

package/dist/contracts/data/gatingPolicies.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GATING_POLICIES = exports.MEDIA_TOOL_NAMES = void 0;
+exports.populateContractsGatingPolicies = populateContractsGatingPolicies;
+exports.MEDIA_TOOL_NAMES = [
+    'generate_image',
+    'edit_image',
+    'restore_photo',
+    'apply_style',
+    'refine_result',
+    'animate_photo',
+    'change_angle',
+    'generate_video',
+    'sound_to_video',
+    'video_to_video',
+    'generate_music',
+    'extend_video',
+    'replace_video_segment',
+    'overlay_video',
+    'add_subtitles',
+    'stitch_video',
+    'orbit_video',
+    'dance_montage',
+];
+exports.GATING_POLICIES = [
+    {
+        policyId: 'DIAGNOSTIC_REQUEST',
+        version: '1.0.0',
+        trigger: { allOf: ['asks_about_previous_error', 'has_prior_generation_context'] },
+        effect: { forbid: [...exports.MEDIA_TOOL_NAMES] },
+        rationale: 'The latest user message asks about a previous error. Do not retry media; ' +
+            'answer from prior tool calls and context.',
+    },
+    {
+        policyId: 'GENERATION_DETAILS_QUERY',
+        version: '1.0.0',
+        trigger: { allOf: ['asks_about_generation_details', 'has_prior_generation_context'] },
+        effect: { forbid: [...exports.MEDIA_TOOL_NAMES] },
+        rationale: 'The latest user message asks about prior generation details. Do not create ' +
+            'or retry media; answer only from prior tool calls.',
+    },
+    {
+        policyId: 'TEXT_ONLY_REQUEST',
+        version: '1.0.0',
+        trigger: { allOf: ['requests_text_only_response'] },
+        effect: { forbid: [...exports.MEDIA_TOOL_NAMES] },
+        rationale: 'The latest user message requests a text-only response. Do not call any ' +
+            'media generation tools.',
+    },
+    {
+        policyId: 'DIAGNOSTIC_COMPLAINT',
+        version: '1.0.0',
+        trigger: { allOf: ['requests_diagnostic_response', 'has_prior_generation_context'] },
+        effect: { forbid: [...exports.MEDIA_TOOL_NAMES] },
+        rationale: 'The latest user message is a diagnostic complaint about prior output. Do not ' +
+            'create or retry media; explain what likely went wrong.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_PRESENT',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'requests_video_modification'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                requests_video_modification: 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+        },
+        rationale: 'A user-uploaded video is the base; modify that asset directly instead ' +
+            'of rendering a fresh clip.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_EXTEND',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:extend'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:extend': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['extend_video'],
+        },
+        rationale: 'The planner identified uploaded-video extension. Use extend_video on the ' +
+            'uploaded base; do not create a separate fresh clip.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_REPLACE',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:replace_segment'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:replace_segment': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['replace_video_segment'],
+        },
+        rationale: 'The planner identified an uploaded-video segment replacement. Use ' +
+            'replace_video_segment on the uploaded base.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_OVERLAY',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:overlay'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:overlay': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['overlay_video'],
+        },
+        rationale: 'The planner identified an uploaded-video overlay. Use overlay_video on ' +
+            'the uploaded base.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_SUBTITLES',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:subtitles'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:subtitles': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['add_subtitles'],
+        },
+        rationale: 'The planner identified uploaded-video subtitles. Use add_subtitles on ' +
+            'the uploaded base.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_TRANSFORM',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:transform'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:transform': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['video_to_video'],
+        },
+        rationale: 'The planner identified an uploaded-video transform. Use video_to_video ' +
+            'on the uploaded base.',
+    },
+    {
+        policyId: 'UPLOADED_BASE_VIDEO_STITCH',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_uploaded_video', 'video_modification:stitch'],
+            sources: {
+                has_uploaded_video: 'session_state',
+                'video_modification:stitch': 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_video', 'animate_photo'],
+            require: ['stitch_video'],
+        },
+        rationale: 'The planner identified uploaded-video stitching. Use stitch_video with ' +
+            'the uploaded clips instead of rendering a fresh clip.',
+    },
+    {
+        policyId: 'HAS_PERSONA_AND_REQUESTS_VIDEO',
+        version: '1.0.0',
+        trigger: {
+            allOf: [
+                'has_active_persona',
+                'requests_video_generation',
+                'no_persona_image_in_session',
+            ],
+            sources: {
+                has_active_persona: 'session_state',
+                requests_video_generation: 'planner',
+                no_persona_image_in_session: 'session_state',
+            },
+        },
+        effect: { forbid: [], require: ['resolve_personas', 'edit_image'] },
+        rationale: 'Persona videos require an image stage first: resolve_personas, then ' +
+            'edit_image to render the persona, then animate. Do not go text-to-video.',
+    },
+    {
+        policyId: 'HAS_PERSONA_AND_REQUESTS_PERSONA_IMAGE',
+        version: '1.0.0',
+        trigger: {
+            allOf: ['has_active_persona', 'requests_persona_image_generation'],
+            sources: {
+                has_active_persona: 'session_state',
+                requests_persona_image_generation: 'planner',
+            },
+        },
+        effect: {
+            forbid: ['generate_image'],
+            require: ['edit_image'],
+        },
+        rationale: 'Persona images must use edit_image with the persona reference photo, ' +
+            'never generate_image (which has no access to the persona identity).',
+    },
+];
+function populateContractsGatingPolicies(registry) {
+    for (const policy of exports.GATING_POLICIES) {
+        registry.registerGatingPolicy(policy);
+    }
+}
+//# sourceMappingURL=gatingPolicies.js.map

package/dist/contracts/data/gatingPolicies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatingPolicies.js","sourceRoot":"","sources":["../../../src/contracts/data/gatingPolicies.ts"],"names":[],"mappings":"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"}

package/dist/contracts/data/gatingPoliciesToolSurface.d.ts

@@ -0,0 +1,7 @@
+import type { ContractRegistry } from '../registry.js';
+import type { ToolGatingPolicy } from '../toolGatingPolicy.js';
+export declare const IMAGE_CONTEXT_TOOL_NAMES: ReadonlyArray<string>;
+export declare const VIDEO_CONTEXT_TOOL_NAMES: ReadonlyArray<string>;
+export declare const TOOL_SURFACE_GATING_POLICIES: ReadonlyArray<ToolGatingPolicy>;
+export declare function populateContractsToolSurfaceGatingPolicies(registry: ContractRegistry): void;
+//# sourceMappingURL=gatingPoliciesToolSurface.d.ts.map

package/dist/contracts/data/gatingPoliciesToolSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatingPoliciesToolSurface.d.ts","sourceRoot":"","sources":["../../../src/contracts/data/gatingPoliciesToolSurface.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,MAAM,CAS1D,CAAC;AAiBF,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,MAAM,CAM1D,CAAC;AAeF,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,gBAAgB,CAkCxE,CAAC;AAEF,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAIN"}

package/dist/contracts/data/gatingPoliciesToolSurface.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_SURFACE_GATING_POLICIES = exports.VIDEO_CONTEXT_TOOL_NAMES = exports.IMAGE_CONTEXT_TOOL_NAMES = void 0;
+exports.populateContractsToolSurfaceGatingPolicies = populateContractsToolSurfaceGatingPolicies;
+exports.IMAGE_CONTEXT_TOOL_NAMES = [
+    'edit_image',
+    'restore_photo',
+    'apply_style',
+    'refine_result',
+    'change_angle',
+    'animate_photo',
+    'dance_montage',
+    'orbit_video',
+];
+exports.VIDEO_CONTEXT_TOOL_NAMES = [
+    'video_to_video',
+    'extend_video',
+    'replace_video_segment',
+    'overlay_video',
+    'add_subtitles',
+];
+const IMAGE_UNLOCK_SIGNALS = [
+    'has_uploaded_image',
+    'has_generated_image',
+    'has_active_persona',
+];
+const VIDEO_UNLOCK_SIGNALS = [
+    'has_uploaded_video',
+    'has_generated_video',
+];
+exports.TOOL_SURFACE_GATING_POLICIES = [
+    {
+        policyId: 'LOCK_IMAGE_CONTEXT_TOOLS_WHEN_NO_IMAGE_SCOPE',
+        version: '1.0.0',
+        trigger: {
+            allOf: [],
+            noneOf: [...IMAGE_UNLOCK_SIGNALS],
+        },
+        effect: { forbid: [...exports.IMAGE_CONTEXT_TOOL_NAMES] },
+        rationale: 'No image is in scope (no uploaded image, no generated image, no active persona). ' +
+            'Hide image-edit / iteration / animation tools so the model picks generate_image ' +
+            'instead of an edit variant it cannot supply a source for.',
+    },
+    {
+        policyId: 'LOCK_VIDEO_CONTEXT_TOOLS_WHEN_NO_VIDEO_SCOPE',
+        version: '1.0.0',
+        trigger: {
+            allOf: [],
+            noneOf: [...VIDEO_UNLOCK_SIGNALS],
+        },
+        effect: { forbid: [...exports.VIDEO_CONTEXT_TOOL_NAMES] },
+        rationale: 'No video is in scope. Hide video post-production / transformation tools — they ' +
+            'cannot operate without an existing video.',
+    },
+];
+function populateContractsToolSurfaceGatingPolicies(registry) {
+    for (const policy of exports.TOOL_SURFACE_GATING_POLICIES) {
+        registry.registerGatingPolicy(policy);
+    }
+}
+//# sourceMappingURL=gatingPoliciesToolSurface.js.map