@sogni-ai/sogni-intelligence-client 2.1.0

package/dist/contracts/data/toolCostMetadata.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_COST_METADATA = void 0;
+exports.getToolCostMetadata = getToolCostMetadata;
+exports.listPaidTools = listPaidTools;
+exports.listToolsByRiskLevel = listToolsByRiskLevel;
+exports.populateToolCostMetadata = populateToolCostMetadata;
+exports.TOOL_COST_METADATA = [
+    {
+        tool: 'generate_image',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per image',
+        description: 'Text-to-image generation. Multiple variations supported.',
+    },
+    {
+        tool: 'edit_image',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per output image',
+        description: 'Instruction-based edit using uploaded or generated source images.',
+    },
+    {
+        tool: 'restore_photo',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per restored image',
+        description: 'AI photo restoration. Repairs scratches, color, exposure.',
+    },
+    {
+        tool: 'apply_style',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per styled image',
+        description: 'Artistic style transfer onto an existing image.',
+    },
+    {
+        tool: 'refine_result',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per refined image',
+        description: 'Iterative refinement / upscale on a prior result.',
+    },
+    {
+        tool: 'change_angle',
+        costClass: 'image.standard',
+        riskLevel: 'paid',
+        userVisibleCost: '1 credit per novel view',
+        description: 'Novel view synthesis from a single source image.',
+    },
+    {
+        tool: 'generate_video',
+        costClass: 'video.vendor.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-second pricing, varies by model',
+        description: 'Text-to-video or reference-driven video generation.',
+    },
+    {
+        tool: 'animate_photo',
+        costClass: 'video.premium',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-second pricing on LTX or WAN',
+        description: 'Photo-to-video animation with motion + audio.',
+    },
+    {
+        tool: 'sound_to_video',
+        costClass: 'video.premium',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-second pricing, audio-synced',
+        description: 'Audio-driven video generation with lip sync.',
+    },
+    {
+        tool: 'video_to_video',
+        costClass: 'video.premium',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-second pricing with ControlNet',
+        description: 'Video style transfer / restyling with ControlNet.',
+    },
+    {
+        tool: 'generate_music',
+        costClass: 'audio.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'Per-second audio pricing',
+        description: 'Music generation with lyrics, BPM, key, style control.',
+    },
+    {
+        tool: 'enhance_prompt',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Enhance or adapt a rough prompt into model-ready generation text.',
+    },
+    {
+        tool: 'compose_script',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Compose scripts, storyboards, campaign beats, or video prompts.',
+    },
+    {
+        tool: 'compose_lyrics',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Compose vocal song lyrics and suggested musical parameters.',
+    },
+    {
+        tool: 'compose_instrumental',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Compose instrumental structures and suggested musical parameters.',
+    },
+    {
+        tool: 'compose_workflow',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Compose a runnable durable creative workflow plan from a brief.',
+    },
+    {
+        tool: 'compose_workflow_template',
+        costClass: 'compose.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'LLM token pricing',
+        description: 'Compose a savable, parameterized workflow template plus a concrete example plan from a brief.',
+    },
+    {
+        tool: 'analyze_image',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free (LLM vision only)',
+        description: 'Vision analysis of an uploaded or generated image.',
+    },
+    {
+        tool: 'analyze_video',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free (LLM vision only)',
+        description: 'Vision/audio analysis of an uploaded or generated video.',
+    },
+    {
+        tool: 'extract_metadata',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Extract metadata from prior generated results.',
+    },
+    {
+        tool: 'stitch_video',
+        costClass: 'compose.ffmpeg',
+        riskLevel: 'paid',
+        userVisibleCost: 'Small compose fee + render-seconds for transitions',
+        description: 'Joins multiple video clips with optional crossfade.',
+    },
+    {
+        tool: 'orbit_video',
+        costClass: 'video.premium',
+        riskLevel: 'paid',
+        userVisibleCost: 'Multiple video renders + compose',
+        description: 'Self-contained orbit-around-subject video pipeline.',
+    },
+    {
+        tool: 'dance_montage',
+        costClass: 'video.premium',
+        riskLevel: 'paid',
+        userVisibleCost: 'Multiple video renders + compose',
+        description: 'Dance video montage from an uploaded photo.',
+    },
+    {
+        tool: 'extend_video',
+        costClass: 'video.vendor.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-seconds for the appended segment',
+        description: 'Add seconds to the end (or start) of an existing video.',
+    },
+    {
+        tool: 'replace_video_segment',
+        costClass: 'video.vendor.standard',
+        riskLevel: 'paid',
+        userVisibleCost: 'Render-seconds for the replaced window',
+        description: 'Regenerate a specific time window of an existing video.',
+    },
+    {
+        tool: 'overlay_video',
+        costClass: 'compose.ffmpeg',
+        riskLevel: 'paid',
+        userVisibleCost: 'Small ffmpeg compose fee',
+        description: 'Overlay logo / text / caption / watermark onto video frames.',
+    },
+    {
+        tool: 'add_subtitles',
+        costClass: 'compose.ffmpeg',
+        riskLevel: 'paid',
+        userVisibleCost: 'Small ffmpeg compose fee',
+        description: 'Burn subtitles into a video.',
+    },
+    {
+        tool: 'resolve_personas',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Match user references to registered personas.',
+    },
+    {
+        tool: 'manage_memory',
+        costClass: 'free',
+        riskLevel: 'destructive',
+        userVisibleCost: 'Free',
+        description: 'Persist or delete long-term user memory entries.',
+    },
+    {
+        tool: 'set_content_filter',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Toggle the safe content filter on or off.',
+    },
+    {
+        tool: 'ask_clarifying_question',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Ask the user for clarification; ends the turn.',
+    },
+    {
+        tool: 'finalize_response',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Mark the turn complete with a short summary.',
+    },
+    {
+        tool: 'create_asset_manifest',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Create the session-scoped three-layer asset manifest.',
+    },
+    {
+        tool: 'inspect_asset',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Read one entry from the asset manifest.',
+    },
+    {
+        tool: 'label_asset',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Add or rename a user_label on an asset.',
+    },
+    {
+        tool: 'map_assets_for_model',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Translate asset_ids to per-model_ref tokens.',
+    },
+    {
+        tool: 'validate_asset_references',
+        costClass: 'free',
+        riskLevel: 'safe',
+        userVisibleCost: 'Free',
+        description: 'Validate that a prompt only references known assets.',
+    },
+];
+const METADATA_BY_TOOL = new Map(exports.TOOL_COST_METADATA.map((entry) => [entry.tool, entry]));
+function getToolCostMetadata(toolName) {
+    return METADATA_BY_TOOL.get(toolName);
+}
+function listPaidTools() {
+    return exports.TOOL_COST_METADATA.filter((entry) => entry.costClass !== 'free');
+}
+function listToolsByRiskLevel(level) {
+    return exports.TOOL_COST_METADATA.filter((entry) => entry.riskLevel === level);
+}
+function populateToolCostMetadata(registry) {
+    for (const metadata of exports.TOOL_COST_METADATA) {
+        registry.registerToolCostMetadata(metadata);
+    }
+}
+//# sourceMappingURL=toolCostMetadata.js.map

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

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

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

@@ -0,0 +1,27 @@
+import { type ToolRiskLevel } from './toolCostMetadata.js';
+import type { ContractRegistry } from '../registry.js';
+export type ToolPermissionDecision = 'allow' | 'require_user_approval' | 'require_explicit_intent';
+export interface ToolPermission {
+    tool: string;
+    decision: ToolPermissionDecision;
+    riskLevel: ToolRiskLevel;
+    requiresUserApproval: boolean;
+    userVisibleCost: string;
+}
+export interface PermissionGateOutcome {
+    allowed: boolean;
+    reason?: string;
+    decision: ToolPermissionDecision;
+}
+export interface PermissionGateInput {
+    toolName: string;
+    latestUserText: string;
+    alreadyAskingClarification?: boolean;
+}
+export declare const TOOL_PERMISSIONS: ReadonlyArray<ToolPermission>;
+export declare function getToolPermission(toolName: string): ToolPermission | undefined;
+export declare function toolRequiresUserApproval(toolName: string): boolean;
+export declare function getToolPermissionDecision(toolName: string): ToolPermissionDecision;
+export declare function evaluatePermissionGate(input: PermissionGateInput): PermissionGateOutcome;
+export declare function populateToolPermissions(registry: ContractRegistry): void;
+//# sourceMappingURL=toolPermissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolPermissions.d.ts","sourceRoot":"","sources":["../../../src/contracts/data/toolPermissions.ts"],"names":[],"mappings":"AAuBA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,cAAc;IAE7B,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,sBAAsB,CAAC;IAEjC,SAAS,EAAE,aAAa,CAAC;IAIzB,oBAAoB,EAAE,OAAO,CAAC;IAG9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAEpC,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,EAAE,MAAM,CAAC;IAEvB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAyBD,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,cAAc,CACnB,CAAC;AAYzC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9E;AAOD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGlE;AASD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAElF;AAoBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,qBAAqB,CA2BxF;AAKD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAIxE"}

package/dist/contracts/data/toolPermissions.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_PERMISSIONS = void 0;
+exports.getToolPermission = getToolPermission;
+exports.toolRequiresUserApproval = toolRequiresUserApproval;
+exports.getToolPermissionDecision = getToolPermissionDecision;
+exports.evaluatePermissionGate = evaluatePermissionGate;
+exports.populateToolPermissions = populateToolPermissions;
+const toolCostMetadata_js_1 = require("./toolCostMetadata.js");
+function decisionForRisk(level) {
+    switch (level) {
+        case 'safe':
+            return 'allow';
+        case 'paid':
+            return 'require_user_approval';
+        case 'destructive':
+            return 'require_explicit_intent';
+    }
+}
+function makePermission(entry) {
+    const decision = decisionForRisk(entry.riskLevel);
+    return {
+        tool: entry.tool,
+        decision,
+        riskLevel: entry.riskLevel,
+        requiresUserApproval: decision !== 'allow',
+        userVisibleCost: entry.userVisibleCost,
+    };
+}
+exports.TOOL_PERMISSIONS = toolCostMetadata_js_1.TOOL_COST_METADATA.map(makePermission);
+const PERMISSION_BY_TOOL = new Map(exports.TOOL_PERMISSIONS.map((entry) => [entry.tool, entry]));
+function getToolPermission(toolName) {
+    return PERMISSION_BY_TOOL.get(toolName);
+}
+function toolRequiresUserApproval(toolName) {
+    const entry = getToolPermission(toolName);
+    return entry ? entry.requiresUserApproval : false;
+}
+function getToolPermissionDecision(toolName) {
+    return getToolPermission(toolName)?.decision ?? 'allow';
+}
+const EXPLICIT_INTENT_PATTERNS = {
+    manage_memory: /\b(?:save|remember|store|note|memorize|forget|delete|remove|wipe|clear)\b[\s\S]{0,80}\b(?:memory|memories|note|notes|preference|preferences|fact|facts|profile|about\s+me)\b/i,
+};
+function evaluatePermissionGate(input) {
+    const perm = getToolPermission(input.toolName);
+    if (!perm) {
+        return { allowed: true, decision: 'allow' };
+    }
+    if (perm.decision === 'allow' || perm.decision === 'require_user_approval') {
+        return { allowed: true, decision: perm.decision };
+    }
+    if (input.alreadyAskingClarification) {
+        return { allowed: true, decision: perm.decision };
+    }
+    const pattern = EXPLICIT_INTENT_PATTERNS[input.toolName];
+    if (!pattern) {
+        return {
+            allowed: false,
+            decision: 'require_explicit_intent',
+            reason: `${input.toolName} is destructive and requires explicit user instruction. Please ask the user to confirm before invoking it.`,
+        };
+    }
+    if (pattern.test(input.latestUserText)) {
+        return { allowed: true, decision: 'require_explicit_intent' };
+    }
+    return {
+        allowed: false,
+        decision: 'require_explicit_intent',
+        reason: `${input.toolName} requires the user to explicitly ask for the action (e.g. "save this", "remember that", "forget X"). The latest message does not contain that intent; ask the user to confirm before invoking.`,
+    };
+}
+function populateToolPermissions(registry) {
+    for (const permission of exports.TOOL_PERMISSIONS) {
+        registry.registerToolPermission(permission);
+    }
+}
+//# sourceMappingURL=toolPermissions.js.map

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

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

package/dist/contracts/evaluators.d.ts

@@ -0,0 +1,94 @@
+import type { ContractRegistry } from './registry.js';
+import { type Signal, type TurnPolicy } from './turnPolicy.js';
+import type { ContractsTelemetrySink } from './telemetry.js';
+export interface ClassifyTurnInput {
+    messages: ReadonlyArray<{
+        role: string;
+        content: string;
+    }>;
+    assetManifest: {
+        items: ReadonlyArray<{
+            id: string;
+            kind: string;
+        }>;
+    };
+    sessionState: {
+        hasPriorGenerationContext?: boolean;
+        hasGeneratedImage?: boolean;
+        hasGeneratedVideo: boolean;
+        hasGeneratedAudio?: boolean;
+        hasUploadedImage?: boolean;
+        hasUploadedVideo: boolean;
+        hasUploadedAudio?: boolean;
+        hasActivePersona?: boolean;
+        noPersonaImageInSession?: boolean;
+        awaitingImageSelection?: boolean;
+        pendingStitchAfterBatch?: boolean;
+        completedWorkflow?: boolean;
+        lastTool?: string;
+        lastToolError?: string;
+        repairCount: number;
+    };
+    availableTools: ReadonlyArray<string>;
+    registry: ContractRegistry;
+    signals: ReadonlyArray<Signal>;
+    telemetry?: ContractsTelemetrySink;
+}
+export declare function classifyTurn(input: ClassifyTurnInput): TurnPolicy;
+export interface ToolDefinitionLike {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface CompileToolsForTurnInput {
+    turnPolicy: TurnPolicy;
+    registry: ContractRegistry;
+    availableToolDefinitions: ReadonlyArray<ToolDefinitionLike>;
+    telemetry?: ContractsTelemetrySink;
+}
+export interface CompiledToolset {
+    tools: ToolDefinitionLike[];
+    contextBlock: string;
+}
+export declare function compileToolsForTurn(input: CompileToolsForTurnInput): CompiledToolset;
+export interface ToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export type DispatchResult = {
+    kind: 'execute';
+    args: Record<string, unknown>;
+} | {
+    kind: 'execute_with_repair';
+    args: Record<string, unknown>;
+    repairNote: string;
+    recipeId: string;
+} | {
+    kind: 'repair';
+    nextToolName: string;
+    rationale: string;
+    recipeId: string;
+} | {
+    kind: 'reject';
+    rationale: string;
+    gatingPolicyId: string;
+} | {
+    kind: 'ask_user';
+    userQuestion: string;
+    recipeId: string;
+};
+export interface DispatchToolCallInput {
+    call: ToolCall;
+    turnPolicy: TurnPolicy;
+    registry: ContractRegistry;
+    errorCode?: string;
+    noteContext?: Record<string, string | number>;
+    repairCount?: number;
+    repairLedger?: Readonly<Record<string, number>>;
+    telemetry?: ContractsTelemetrySink;
+}
+export declare function dispatchToolCall(input: DispatchToolCallInput): DispatchResult;
+//# sourceMappingURL=evaluators.d.ts.map

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

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