@sogni-ai/sogni-intelligence-client 3.0.0-alpha.0

package/dist/contracts/repairRecipe.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRepairRecipe = isRepairRecipe;
+const VALID_MODES = new Set([
+    'autoRepair',
+    'suggestFollowup',
+    'stopAndAsk',
+]);
+function isRepairRecipe(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.recipeId !== 'string' || v.recipeId.length === 0)
+        return false;
+    if (typeof v.version !== 'string' || v.version.length === 0)
+        return false;
+    if (typeof v.toolName !== 'string' || v.toolName.length === 0)
+        return false;
+    if (typeof v.errorCode !== 'string' || v.errorCode.length === 0)
+        return false;
+    if (typeof v.mode !== 'string' || !VALID_MODES.has(v.mode))
+        return false;
+    if (typeof v.maxRetries !== 'number' || !Number.isFinite(v.maxRetries) || v.maxRetries < 0)
+        return false;
+    if (typeof v.repairNoteTemplate !== 'string')
+        return false;
+    if (v.autoRepairFields !== undefined) {
+        if (!Array.isArray(v.autoRepairFields))
+            return false;
+        if (v.autoRepairFields.some((x) => typeof x !== 'string'))
+            return false;
+    }
+    if (v.suggestedFollowupTool !== undefined && typeof v.suggestedFollowupTool !== 'string') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=repairRecipe.js.map

package/dist/contracts/repairRecipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repairRecipe.js","sourceRoot":"","sources":["../../src/contracts/repairRecipe.ts"],"names":[],"mappings":";;AA2CA,wCAkBC;AArDD,MAAM,WAAW,GAAkC,IAAI,GAAG,CAAC;IACzD,YAAY;IACZ,iBAAiB;IACjB,YAAY;CACb,CAAC,CAAC;AA+BH,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAwB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzG,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,qBAAqB,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,qBAAqB,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/contracts/storyboard.d.ts

@@ -0,0 +1,112 @@
+import type { StoryboardPlanningContract, StoryboardPlanningSource } from '../public-skill-runtime/index.js';
+export declare const CAMPAIGN_STORYBOARD_SCHEMA_VERSION: "campaign-storyboard/v1";
+export declare const CAMPAIGN_STORYBOARD_METADATA_PREFIX = "SOGNI_CAMPAIGN_STORYBOARD_JSON:";
+export type CampaignReferenceAssetType = 'character' | 'logo' | 'product' | 'style' | 'first_frame' | 'last_frame' | 'motion_reference' | 'audio_reference' | 'storyboard' | 'background' | 'other';
+export type CampaignReferenceUsageScope = 'global' | 'scenes' | 'end_card_only' | 'motion_only' | 'style_only';
+export type CampaignPreservePriority = 'critical' | 'high' | 'medium' | 'low';
+export type CampaignProductionMode = 'fast_draft' | 'production';
+export interface CampaignReferenceAsset {
+    id: string;
+    tag?: string;
+    sourceIndex?: number;
+    assetType: CampaignReferenceAssetType;
+    usageScope: CampaignReferenceUsageScope;
+    preservePriority: CampaignPreservePriority;
+    description: string;
+    assignedSceneIds: string[];
+}
+export interface CampaignVoiceLine {
+    sceneId: string;
+    startSec: number | null;
+    endSec: number | null;
+    text: string;
+    delivery: string;
+    priority: 'required' | 'optional';
+}
+export interface CampaignSceneSpec {
+    id: string;
+    index: number;
+    title: string;
+    startSec: number | null;
+    endSec: number | null;
+    durationSec: number | null;
+    purpose: string;
+    productFeature: string;
+    visual: string;
+    action: string;
+    camera: string;
+    lighting: string;
+    transitionIn: string;
+    transitionOut: string;
+    dialogue: string;
+    voiceoverLines: CampaignVoiceLine[];
+    audioSfx: string[];
+    music: string;
+    referenceUsage: string[];
+    visibleText: string[];
+    metadataLabels: string[];
+    mustAvoid: string[];
+    firstFrame: string;
+    lastFrame: string;
+}
+export interface CampaignTransition {
+    fromSceneId: string;
+    toSceneId: string;
+    description: string;
+    audioBridge: string;
+}
+export interface CampaignStoryboard {
+    schemaVersion: typeof CAMPAIGN_STORYBOARD_SCHEMA_VERSION;
+    project: {
+        title: string;
+        durationSec: number | null;
+        targetVideoAspectRatio: string;
+        storyboardCanvasAspectRatio: string;
+        storyboardCellAspectRatio: string;
+        storyboardLayout: string;
+        layoutSource?: StoryboardPlanningSource;
+        outputUse: 'storyboard_image' | 'video_prompt' | 'both';
+        productionMode: CampaignProductionMode;
+    };
+    planningContract?: StoryboardPlanningContract;
+    references: CampaignReferenceAsset[];
+    creativeBrief: {
+        concept: string;
+        oneSentenceStorySpine: string;
+        toneProgression: string[];
+        visualStyle: string;
+        mustInclude: string[];
+        mustAvoid: string[];
+        brandRules: string[];
+    };
+    voiceover: {
+        fullScript: string;
+        lines: CampaignVoiceLine[];
+    };
+    scenes: CampaignSceneSpec[];
+    transitions: CampaignTransition[];
+    endCard: {
+        requiredText: string[];
+        logoReferenceId?: string;
+        holdDurationSec: number;
+        visualTreatment: string;
+    };
+    audio: {
+        musicArc: string;
+        globalSfxPalette: string[];
+    };
+    source: {
+        prompt: string;
+        userIntentText: string;
+        approvedScriptContext: string | null;
+        frameCount: number;
+        promptAuthorship?: 'user' | 'assistant';
+    };
+}
+export interface CampaignStoryboardValidationResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare const SEEDANCE_STORYBOARD_REFERENCE_PROMPT = "Create a full-screen cinematic video from the storyboard in @Image1. Treat @Image1 as the controlling source for shot order and intent, and as a source layout reference: use the thumbnails, timing, Dialogue/VO, Audio/SFX, timecodes, camera/motion notes, transitions, and scene order as instructions, not as a visual board to reproduce. Do not display the storyboard grid, borders, caption bars, storyboard title/footer text, panel numbers, section labels, slide titles, headings, or transcribed narration. Convert the ordered thumbnails into full-screen chronological beats; do not reuse only one or two motifs while skipping panels. When the board has panel titles, captions, section numbers, slide titles, or headings but no formal Dialogue/VO labels, treat those labels as short audio-only narration/voiceover or key-message beats in order unless they are clearly visual-only metadata. Voice each label as its own brief phrase with a pause; do not concatenate labels into run-on sentences and do not speak panel numbers. Show storyboard labels as visible text only when the user explicitly asks for visible text, subtitles, a title card, lower third, signage, or a title/end frame. Preserve the story spine, character/product/reference continuity, and cause-and-effect progression between beats. Treat transitions as motion instructions, not unrelated hard cuts unless the storyboard explicitly asks for hard cuts. Use brand color, lighting, product imagery, and composition instead of invented typography. Keep visible text limited to exact copy the user or storyboard explicitly marks as on-screen text, signage, title text, or end-frame text. Use a music/SFX arc that follows the storyboard audio notes and lands the final beat. Keep unrelated UI, extra logos, microtext, subtitles, and extra scenes out of the frame.";
+//# sourceMappingURL=storyboard.d.ts.map

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

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

package/dist/contracts/storyboard.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEEDANCE_STORYBOARD_REFERENCE_PROMPT = exports.CAMPAIGN_STORYBOARD_METADATA_PREFIX = exports.CAMPAIGN_STORYBOARD_SCHEMA_VERSION = void 0;
+exports.CAMPAIGN_STORYBOARD_SCHEMA_VERSION = 'campaign-storyboard/v1';
+exports.CAMPAIGN_STORYBOARD_METADATA_PREFIX = 'SOGNI_CAMPAIGN_STORYBOARD_JSON:';
+exports.SEEDANCE_STORYBOARD_REFERENCE_PROMPT = 'Create a full-screen cinematic video from the storyboard in @Image1. Treat @Image1 as the controlling source for shot order and intent, and as a source layout reference: use the thumbnails, timing, Dialogue/VO, Audio/SFX, timecodes, camera/motion notes, transitions, and scene order as instructions, not as a visual board to reproduce. Do not display the storyboard grid, borders, caption bars, storyboard title/footer text, panel numbers, section labels, slide titles, headings, or transcribed narration. Convert the ordered thumbnails into full-screen chronological beats; do not reuse only one or two motifs while skipping panels. When the board has panel titles, captions, section numbers, slide titles, or headings but no formal Dialogue/VO labels, treat those labels as short audio-only narration/voiceover or key-message beats in order unless they are clearly visual-only metadata. Voice each label as its own brief phrase with a pause; do not concatenate labels into run-on sentences and do not speak panel numbers. Show storyboard labels as visible text only when the user explicitly asks for visible text, subtitles, a title card, lower third, signage, or a title/end frame. Preserve the story spine, character/product/reference continuity, and cause-and-effect progression between beats. Treat transitions as motion instructions, not unrelated hard cuts unless the storyboard explicitly asks for hard cuts. Use brand color, lighting, product imagery, and composition instead of invented typography. Keep visible text limited to exact copy the user or storyboard explicitly marks as on-screen text, signage, title text, or end-frame text. Use a music/SFX arc that follows the storyboard audio notes and lands the final beat. Keep unrelated UI, extra logos, microtext, subtitles, and extra scenes out of the frame.';
+//# sourceMappingURL=storyboard.js.map

package/dist/contracts/storyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard.js","sourceRoot":"","sources":["../../src/contracts/storyboard.ts"],"names":[],"mappings":";;;AASa,QAAA,kCAAkC,GAAG,wBAAiC,CAAC;AACvE,QAAA,mCAAmC,GAAG,iCAAiC,CAAC;AAyIxE,QAAA,oCAAoC,GAC/C,iyDAAiyD,CAAC"}

package/dist/contracts/telemetry.d.ts

@@ -0,0 +1,57 @@
+import type { Signal } from './turnPolicy.js';
+export interface TurnClassifiedPayload {
+    signals: Signal[];
+    visibleToolsCount: number;
+    appliedPolicies: string[];
+    rationale: string;
+}
+export interface GatingPolicyAppliedPayload {
+    policyId: string;
+    matchedSignals: string[];
+    forbiddenTools: string[];
+    requiredTools: string[];
+}
+export interface PromptContractEmittedPayload {
+    toolName: string;
+    contractVersion: string;
+    bakedDescriptionLength: number;
+}
+export interface ToolDispatchResolvedPayload {
+    toolName: string;
+    resultKind: 'execute' | 'execute_with_repair' | 'repair' | 'reject' | 'ask_user';
+}
+export interface RepairRecipeFiredPayload {
+    toolName: string;
+    errorCode: string;
+    recipeId: string;
+    mode: 'autoRepair' | 'suggestFollowup' | 'stopAndAsk';
+}
+export type ContractsTelemetryEvent = {
+    kind: 'turn_classified';
+    timestamp: number;
+    payload: TurnClassifiedPayload;
+} | {
+    kind: 'gating_policy_applied';
+    timestamp: number;
+    payload: GatingPolicyAppliedPayload;
+} | {
+    kind: 'prompt_contract_emitted';
+    timestamp: number;
+    payload: PromptContractEmittedPayload;
+} | {
+    kind: 'tool_dispatch_resolved';
+    timestamp: number;
+    payload: ToolDispatchResolvedPayload;
+} | {
+    kind: 'repair_recipe_fired';
+    timestamp: number;
+    payload: RepairRecipeFiredPayload;
+};
+export declare function isContractsTelemetryEvent(value: unknown): value is ContractsTelemetryEvent;
+export interface ContractsTelemetrySink {
+    emit(event: ContractsTelemetryEvent): void;
+}
+export declare function makeBufferedSink(capacity?: number): ContractsTelemetrySink & {
+    events(): ContractsTelemetryEvent[];
+};
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/contracts/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EACN,SAAS,GACT,qBAAqB,GACrB,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,YAAY,CAAC;CACvD;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,0BAA0B,CAAA;CAAE,GACzF;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,4BAA4B,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,2BAA2B,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAU1F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAO1F;AAOD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAM,GAAG,sBAAsB,GAAG;IACzE,MAAM,IAAI,uBAAuB,EAAE,CAAC;CACrC,CAWA"}

package/dist/contracts/telemetry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isContractsTelemetryEvent = isContractsTelemetryEvent;
+exports.makeBufferedSink = makeBufferedSink;
+const VALID_KINDS = new Set([
+    'turn_classified',
+    'gating_policy_applied',
+    'prompt_contract_emitted',
+    'tool_dispatch_resolved',
+    'repair_recipe_fired',
+]);
+function isContractsTelemetryEvent(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.kind !== 'string' || !VALID_KINDS.has(v.kind))
+        return false;
+    if (typeof v.timestamp !== 'number')
+        return false;
+    if (v.payload === null || typeof v.payload !== 'object')
+        return false;
+    return true;
+}
+function makeBufferedSink(capacity = 256) {
+    const buf = [];
+    return {
+        emit(event) {
+            buf.push(event);
+            if (buf.length > capacity)
+                buf.splice(0, buf.length - capacity);
+        },
+        events() {
+            return [...buf];
+        },
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/contracts/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/contracts/telemetry.ts"],"names":[],"mappings":";;AAsDA,8DAOC;AAWD,4CAaC;AAvCD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,iBAAiB;IACjB,uBAAuB;IACvB,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;CACtB,CAAC,CAAC;AAEH,SAAgB,yBAAyB,CAAC,KAAc;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,SAAgB,gBAAgB,CAAC,QAAQ,GAAG,GAAG;IAG7C,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,CAAC,KAAK;YACR,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ;gBAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;QAClE,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/contracts/toolGatingPolicy.d.ts

@@ -0,0 +1,19 @@
+import type { SignalSource } from './turnPolicy.js';
+export interface ToolGatingPolicyTrigger {
+    allOf: string[];
+    noneOf?: string[];
+    sources?: Record<string, SignalSource | SignalSource[]>;
+}
+export interface ToolGatingPolicyEffect {
+    forbid: string[];
+    require?: string[];
+}
+export interface ToolGatingPolicy {
+    policyId: string;
+    version: string;
+    trigger: ToolGatingPolicyTrigger;
+    effect: ToolGatingPolicyEffect;
+    rationale: string;
+}
+export declare function isToolGatingPolicy(value: unknown): value is ToolGatingPolicy;
+//# sourceMappingURL=toolGatingPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolGatingPolicy.d.ts","sourceRoot":"","sources":["../../src/contracts/toolGatingPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,MAAM,WAAW,uBAAuB;IAEtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAMlB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,sBAAsB;IAErC,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,sBAAsB,CAAC;IAE/B,SAAS,EAAE,MAAM,CAAC;CACnB;AA+CD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAS5E"}

package/dist/contracts/toolGatingPolicy.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isToolGatingPolicy = isToolGatingPolicy;
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((v) => typeof v === 'string');
+}
+function isSignalSource(value) {
+    return value === 'planner'
+        || value === 'regex'
+        || value === 'classifier'
+        || value === 'session_state';
+}
+function isSourceConstraintMap(value) {
+    if (value === undefined)
+        return true;
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return Object.values(value).every((constraint) => isSignalSource(constraint)
+        || (Array.isArray(constraint) && constraint.length > 0 && constraint.every(isSignalSource)));
+}
+function isTrigger(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const t = value;
+    if (!isStringArray(t.allOf))
+        return false;
+    if (t.noneOf !== undefined && !isStringArray(t.noneOf))
+        return false;
+    const hasAllOf = t.allOf.length > 0;
+    const hasNoneOf = Array.isArray(t.noneOf) && t.noneOf.length > 0;
+    if (!hasAllOf && !hasNoneOf)
+        return false;
+    if (!isSourceConstraintMap(t.sources))
+        return false;
+    return true;
+}
+function isEffect(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const e = value;
+    if (!isStringArray(e.forbid))
+        return false;
+    if (e.require !== undefined && !isStringArray(e.require))
+        return false;
+    return true;
+}
+function isToolGatingPolicy(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.policyId !== 'string' || v.policyId.length === 0)
+        return false;
+    if (typeof v.version !== 'string' || v.version.length === 0)
+        return false;
+    if (!isTrigger(v.trigger))
+        return false;
+    if (!isEffect(v.effect))
+        return false;
+    if (typeof v.rationale !== 'string')
+        return false;
+    return true;
+}
+//# sourceMappingURL=toolGatingPolicy.js.map

package/dist/contracts/toolGatingPolicy.js.map

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

package/dist/contracts/toolPromptMarkers.d.ts

@@ -0,0 +1,9 @@
+export declare const LITERAL_VIDEO_PROMPT_OVERRIDE = "LITERAL PROMPT OVERRIDE: If the user explicitly says not to modify the prompt, or to use it exactly/verbatim/as-is, copy the identified prompt text verbatim instead of applying these construction rules unless a hard requirement is missing. Set skipPromptProcessing=true; for Seedance also set expandPrompt=false.";
+export declare const SEEDANCE_EXPAND_PROMPT_DESCRIPTION = "Seedance only. Whether to run the shared Seedance prompt shaper before dispatch. Defaults to true; set false only when the user explicitly asks to submit the compact prompt directly or not modify the prompt.";
+export declare const GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION = "Bypass automatic prompt shaping/refinement and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as model, duration, count, aspect ratio, and seed. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.";
+export declare const ANIMATE_PHOTO_SKIP_PROMPT_PROCESSING_DESCRIPTION = "Bypass automatic prompt shaping/refinement, image-description anchoring, transition-prompt rewriting, and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as source indices, frameRole, model, duration, count, and aspect ratio. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.";
+export declare const LITERAL_SEEDANCE_PROMPT_OVERRIDE = "LITERAL PROMPT OVERRIDE: If the user explicitly says not to modify the prompt, or to use it exactly/verbatim/as-is, copy the identified prompt text verbatim instead of applying these construction rules unless a hard requirement is missing. For Seedance, set expandPrompt=false.";
+export declare const SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE = "Seedance supports multimodal loose reference assets: images (up to 9), videos (up to 3), and audios (up to 3), with no more than 12 asset files total. Use @Image1/@Video1/@Audio1 style references in creative briefs when assigning roles. Assign every useful reference asset a role and prefer positive preservation constraints. If an uploaded video is the source clip to transform, upscale, enhance, restyle, or remaster, use video_to_video with controlMode=\"seedance-v2v\" instead of generate_video referenceVideoIndices.";
+export declare const SEEDANCE_TOOL_V2V_REFERENCE_GUIDANCE = "Seedance V2V reads @Video1 holistically. Use it for restyling, motion transfer, extension, subject replacement, or scene transformation, and assign @Video1 a clear role such as source clip, camera movement, action timing, edit rhythm, or continuation anchor.";
+export declare const SEEDANCE_TOOL_AUDIO_REFERENCE_GUIDANCE = "For Seedance audio-reference prompts, preserve exact spoken dialogue when the user supplied it, and assign @Image1/@Audio1 roles. If the user asks for speech without words, describe the vocal performance without inventing quoted dialogue. Treat lip-sync, voice cloning, and real-human reference behavior as provider-sensitive rather than guaranteed.";
+//# sourceMappingURL=toolPromptMarkers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolPromptMarkers.d.ts","sourceRoot":"","sources":["../../src/contracts/toolPromptMarkers.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,6BAA6B,6TAC6D,CAAC;AAExG,eAAO,MAAM,kCAAkC,oNACoK,CAAC;AAEpN,eAAO,MAAM,iDAAiD,2jBAC4f,CAAC;AAE3jB,eAAO,MAAM,gDAAgD,2oBAC6kB,CAAC;AAE3oB,eAAO,MAAM,gCAAgC,0RACuB,CAAC;AAErE,eAAO,MAAM,2CAA2C,8gBAA4gB,CAAC;AAErkB,eAAO,MAAM,oCAAoC,uQAAuQ,CAAC;AAEzT,eAAO,MAAM,sCAAsC,kWAAkW,CAAC"}

package/dist/contracts/toolPromptMarkers.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEEDANCE_TOOL_AUDIO_REFERENCE_GUIDANCE = exports.SEEDANCE_TOOL_V2V_REFERENCE_GUIDANCE = exports.SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE = exports.LITERAL_SEEDANCE_PROMPT_OVERRIDE = exports.ANIMATE_PHOTO_SKIP_PROMPT_PROCESSING_DESCRIPTION = exports.GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION = exports.SEEDANCE_EXPAND_PROMPT_DESCRIPTION = exports.LITERAL_VIDEO_PROMPT_OVERRIDE = void 0;
+const promptOverrideMarker_js_1 = require("./promptOverrideMarker.js");
+exports.LITERAL_VIDEO_PROMPT_OVERRIDE = `${promptOverrideMarker_js_1.LITERAL_PROMPT_OVERRIDE} Set skipPromptProcessing=true; for Seedance also set expandPrompt=false.`;
+exports.SEEDANCE_EXPAND_PROMPT_DESCRIPTION = 'Seedance only. Whether to run the shared Seedance prompt shaper before dispatch. Defaults to true; set false only when the user explicitly asks to submit the compact prompt directly or not modify the prompt.';
+exports.GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION = 'Bypass automatic prompt shaping/refinement and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as model, duration, count, aspect ratio, and seed. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.';
+exports.ANIMATE_PHOTO_SKIP_PROMPT_PROCESSING_DESCRIPTION = 'Bypass automatic prompt shaping/refinement, image-description anchoring, transition-prompt rewriting, and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as source indices, frameRole, model, duration, count, and aspect ratio. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.';
+exports.LITERAL_SEEDANCE_PROMPT_OVERRIDE = `${promptOverrideMarker_js_1.LITERAL_PROMPT_OVERRIDE} For Seedance, set expandPrompt=false.`;
+exports.SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE = `Seedance supports multimodal loose reference assets: images (up to 9), videos (up to 3), and audios (up to 3), with no more than 12 asset files total. Use @Image1/@Video1/@Audio1 style references in creative briefs when assigning roles. Assign every useful reference asset a role and prefer positive preservation constraints. If an uploaded video is the source clip to transform, upscale, enhance, restyle, or remaster, use video_to_video with controlMode="seedance-v2v" instead of generate_video referenceVideoIndices.`;
+exports.SEEDANCE_TOOL_V2V_REFERENCE_GUIDANCE = `Seedance V2V reads @Video1 holistically. Use it for restyling, motion transfer, extension, subject replacement, or scene transformation, and assign @Video1 a clear role such as source clip, camera movement, action timing, edit rhythm, or continuation anchor.`;
+exports.SEEDANCE_TOOL_AUDIO_REFERENCE_GUIDANCE = `For Seedance audio-reference prompts, preserve exact spoken dialogue when the user supplied it, and assign @Image1/@Audio1 roles. If the user asks for speech without words, describe the vocal performance without inventing quoted dialogue. Treat lip-sync, voice cloning, and real-human reference behavior as provider-sensitive rather than guaranteed.`;
+//# sourceMappingURL=toolPromptMarkers.js.map

package/dist/contracts/toolPromptMarkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPromptMarkers.js","sourceRoot":"","sources":["../../src/contracts/toolPromptMarkers.ts"],"names":[],"mappings":";;;AAIA,uEAAoE;AAEvD,QAAA,6BAA6B,GACxC,GAAG,iDAAuB,2EAA2E,CAAC;AAE3F,QAAA,kCAAkC,GAC7C,iNAAiN,CAAC;AAEvM,QAAA,iDAAiD,GAC5D,wjBAAwjB,CAAC;AAE9iB,QAAA,gDAAgD,GAC3D,woBAAwoB,CAAC;AAE9nB,QAAA,gCAAgC,GAC3C,GAAG,iDAAuB,wCAAwC,CAAC;AAExD,QAAA,2CAA2C,GAAG,ygBAAygB,CAAC;AAExjB,QAAA,oCAAoC,GAAG,oQAAoQ,CAAC;AAE5S,QAAA,sCAAsC,GAAG,+VAA+V,CAAC"}

package/dist/contracts/toolSurface.d.ts

@@ -0,0 +1,46 @@
+import type { ContractRegistry } from './registry.js';
+import type { ContractsTelemetrySink } from './telemetry.js';
+import type { Signal, TurnPolicy } from './turnPolicy.js';
+import { type ClassifyTurnInput, type CompiledToolset } from './evaluators.js';
+export interface ContractMessageLike {
+    role: string;
+    content: unknown;
+}
+export interface ContractToolDefinitionLike {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+export type ContractToolChoiceLike = 'auto' | 'none' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+export interface BuildContractTurnPolicyInput {
+    availableTools: ReadonlyArray<string>;
+    registry: ContractRegistry;
+    messages?: ReadonlyArray<ContractMessageLike>;
+    assetManifest?: ClassifyTurnInput['assetManifest'];
+    sessionState?: Partial<ClassifyTurnInput['sessionState']>;
+    signals?: ReadonlyArray<Signal>;
+    telemetry?: ContractsTelemetrySink;
+}
+export interface CompileContractToolSurfaceInput extends Omit<BuildContractTurnPolicyInput, 'availableTools'> {
+    tools: ReadonlyArray<ContractToolDefinitionLike>;
+    turnPolicy?: TurnPolicy;
+}
+export interface CompiledContractToolSurface extends CompiledToolset {
+    turnPolicy: TurnPolicy;
+}
+export declare const DEFAULT_CONTRACT_CONTEXT_PREFIX = "Sogni Creative Agent tool policy for this turn:";
+export declare function normalizeContractMessages(messages: ReadonlyArray<ContractMessageLike>): ClassifyTurnInput['messages'];
+export declare function buildContractTurnPolicy(input: BuildContractTurnPolicyInput): TurnPolicy;
+export declare function compileContractToolSurface(input: CompileContractToolSurfaceInput): CompiledContractToolSurface;
+export declare function formatContractsContextBlock(contextBlock: string, prefix?: string): string;
+export declare function appendContractsContextToSystemContent(systemContent: string, contextBlock: string): string;
+export declare function reconcileToolChoiceForCompiledTools<T extends ContractToolChoiceLike | undefined>(toolChoice: T, tools: ReadonlyArray<ContractToolDefinitionLike>): T | 'auto' | undefined;
+//# sourceMappingURL=toolSurface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolSurface.d.ts","sourceRoot":"","sources":["../../src/contracts/toolSurface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAErB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CACH;AAED,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC9C,aAAa,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,4BAA4B,EAAE,gBAAgB,CAAC;IAC3G,KAAK,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,2BAA4B,SAAQ,eAAe;IAClE,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,eAAO,MAAM,+BAA+B,oDACO,CAAC;AAEpD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC3C,iBAAiB,CAAC,UAAU,CAAC,CAK/B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,UAAU,CAevF;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,2BAA2B,CA0B7B;AAED,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,MAAM,SAAkC,GACvC,MAAM,CAIR;AAED,wBAAgB,qCAAqC,CACnD,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED,wBAAgB,mCAAmC,CAAC,CAAC,SAAS,sBAAsB,GAAG,SAAS,EAC9F,UAAU,EAAE,CAAC,EACb,KAAK,EAAE,aAAa,CAAC,0BAA0B,CAAC,GAC/C,CAAC,GAAG,MAAM,GAAG,SAAS,CAQxB"}

package/dist/contracts/toolSurface.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONTRACT_CONTEXT_PREFIX = void 0;
+exports.normalizeContractMessages = normalizeContractMessages;
+exports.buildContractTurnPolicy = buildContractTurnPolicy;
+exports.compileContractToolSurface = compileContractToolSurface;
+exports.formatContractsContextBlock = formatContractsContextBlock;
+exports.appendContractsContextToSystemContent = appendContractsContextToSystemContent;
+exports.reconcileToolChoiceForCompiledTools = reconcileToolChoiceForCompiledTools;
+const evaluators_js_1 = require("./evaluators.js");
+exports.DEFAULT_CONTRACT_CONTEXT_PREFIX = 'Sogni Creative Agent tool policy for this turn:';
+function normalizeContractMessages(messages) {
+    return messages.map((message) => ({
+        role: message.role,
+        content: contractMessageContentToText(message.content),
+    }));
+}
+function buildContractTurnPolicy(input) {
+    return (0, evaluators_js_1.classifyTurn)({
+        messages: normalizeContractMessages(input.messages ?? []),
+        assetManifest: input.assetManifest ?? { items: [] },
+        sessionState: {
+            hasGeneratedVideo: false,
+            hasUploadedVideo: false,
+            repairCount: 0,
+            ...input.sessionState,
+        },
+        availableTools: input.availableTools,
+        registry: input.registry,
+        signals: input.signals ?? [],
+        telemetry: input.telemetry,
+    });
+}
+function compileContractToolSurface(input) {
+    const definitions = input.tools.map(normalizeContractToolDefinition);
+    const availableTools = definitions.map((tool) => tool.function.name);
+    const turnPolicy = input.turnPolicy
+        ? turnPolicyWithDefaultVisibleTools(input.turnPolicy, availableTools)
+        : buildContractTurnPolicy({
+            availableTools,
+            registry: input.registry,
+            messages: input.messages,
+            assetManifest: input.assetManifest,
+            sessionState: input.sessionState,
+            signals: input.signals,
+            telemetry: input.telemetry,
+        });
+    const compiled = (0, evaluators_js_1.compileToolsForTurn)({
+        turnPolicy,
+        registry: input.registry,
+        availableToolDefinitions: definitions,
+        telemetry: input.telemetry,
+    });
+    return {
+        ...compiled,
+        turnPolicy,
+    };
+}
+function formatContractsContextBlock(contextBlock, prefix = exports.DEFAULT_CONTRACT_CONTEXT_PREFIX) {
+    const trimmed = contextBlock.trim();
+    if (!trimmed)
+        return '';
+    return `${prefix}\n${trimmed}`;
+}
+function appendContractsContextToSystemContent(systemContent, contextBlock) {
+    const formatted = formatContractsContextBlock(contextBlock);
+    return formatted ? `${systemContent}\n\n${formatted}` : systemContent;
+}
+function reconcileToolChoiceForCompiledTools(toolChoice, tools) {
+    if (!toolChoice)
+        return toolChoice;
+    if (tools.length === 0)
+        return undefined;
+    if (typeof toolChoice !== 'object' || toolChoice.type !== 'function')
+        return toolChoice;
+    const forcedToolName = toolChoice.function.name;
+    const isStillVisible = tools.some((tool) => tool.function.name === forcedToolName);
+    return isStillVisible ? toolChoice : 'auto';
+}
+function contractMessageContentToText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => {
+        if (part && typeof part === 'object' && 'text' in part) {
+            const text = part.text;
+            return typeof text === 'string' ? text : '';
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join(' ');
+}
+function normalizeContractToolDefinition(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.function.name,
+            description: tool.function.description ?? '',
+            parameters: tool.function.parameters ?? { type: 'object', properties: {} },
+        },
+    };
+}
+function turnPolicyWithDefaultVisibleTools(turnPolicy, availableTools) {
+    if (turnPolicy.visibleTools.length > 0
+        || turnPolicy.forbiddenTools.length > 0
+        || turnPolicy.requiredTools.length > 0
+        || turnPolicy.appliedPolicies.length > 0
+        || turnPolicy.rationale) {
+        return turnPolicy;
+    }
+    return {
+        ...turnPolicy,
+        visibleTools: [...availableTools],
+    };
+}
+//# sourceMappingURL=toolSurface.js.map

package/dist/contracts/toolSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSurface.js","sourceRoot":"","sources":["../../src/contracts/toolSurface.ts"],"names":[],"mappings":";;;AAqDA,8DAOC;AAED,0DAeC;AAED,gEA4BC;AAED,kEAOC;AAED,sFAMC;AAED,kFAWC;AAtID,mDAMyB;AAyCZ,QAAA,+BAA+B,GAC1C,iDAAiD,CAAC;AAEpD,SAAgB,yBAAyB,CACvC,QAA4C;IAE5C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,uBAAuB,CAAC,KAAmC;IACzE,OAAO,IAAA,4BAAY,EAAC;QAClB,QAAQ,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzD,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACnD,YAAY,EAAE;YACZ,iBAAiB,EAAE,KAAK;YACxB,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,CAAC;YACd,GAAG,KAAK,CAAC,YAAY;SACtB;QACD,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,0BAA0B,CACxC,KAAsC;IAEtC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU;QACjC,CAAC,CAAC,iCAAiC,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC;QACrE,CAAC,CAAC,uBAAuB,CAAC;YACxB,cAAc;YACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,IAAA,mCAAmB,EAAC;QACnC,UAAU;QACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,wBAAwB,EAAE,WAAW;QACrC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,QAAQ;QACX,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAgB,2BAA2B,CACzC,YAAoB,EACpB,MAAM,GAAG,uCAA+B;IAExC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,SAAgB,qCAAqC,CACnD,aAAqB,EACrB,YAAoB;IAEpB,MAAM,SAAS,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AACxE,CAAC;AAED,SAAgB,mCAAmC,CACjD,UAAa,EACb,KAAgD;IAEhD,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAExF,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;IAChD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IACnF,OAAO,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAgB;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;YAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,+BAA+B,CACtC,IAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE;YAC5C,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAC3E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,UAAsB,EACtB,cAAqC;IAErC,IACE,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;WAC/B,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;WACpC,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;WACnC,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;WACrC,UAAU,CAAC,SAAS,EACvB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,YAAY,EAAE,CAAC,GAAG,cAAc,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/contracts/turnPolicy.d.ts

@@ -0,0 +1,22 @@
+export type SignalSource = 'planner' | 'regex' | 'classifier' | 'session_state';
+export interface Signal {
+    kind: string;
+    value?: string;
+    source: SignalSource;
+}
+export interface ContextHint {
+    kind: string;
+    body: string;
+}
+export interface TurnPolicy {
+    signals: Signal[];
+    visibleTools: string[];
+    forbiddenTools: string[];
+    forbiddenToolPolicies: Record<string, string>;
+    requiredTools: string[];
+    contextHints: ContextHint[];
+    appliedPolicies: string[];
+    rationale: string;
+}
+export declare function emptyTurnPolicy(): TurnPolicy;
+//# sourceMappingURL=turnPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turnPolicy.d.ts","sourceRoot":"","sources":["../../src/contracts/turnPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,eAAe,CAAC;AAOhF,MAAM,WAAW,MAAM;IAErB,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,YAAY,CAAC;CACtB;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IAMzB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,IAAI,UAAU,CAW5C"}