@sogni-ai/sogni-intelligence-client 2.4.3 → 3.0.0-alpha.10

package/dist/agent/toolMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolMetadata.d.ts","sourceRoot":"","sources":["../../src/agent/toolMetadata.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,aAAa,GACb,UAAU,GACV,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAWd,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;AAMtF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAM5E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,aAAa,GAAG,cAAc,CAAC;AASzE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AAOjF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,qBAAqB,GAAG,UAAU,CAAC;AAMhF,MAAM,WAAW,YAAY;IAK3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,iBAAiB,CAAC;IAKjC,cAAc,EAAE,MAAM,CAAC;IAKvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAK/B,WAAW,EAAE,OAAO,CAAC;IAKrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,WAAW,EAAE,eAAe,CAAC;IAM7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA+CD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAExF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAiBpE;AAGD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAeD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CA8CjF"}

package/dist/agent/toolMetadata.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isToolFamily = isToolFamily;
+exports.isToolExecutionMode = isToolExecutionMode;
+exports.isToolCostClass = isToolCostClass;
+exports.isToolLatencyClass = isToolLatencyClass;
+exports.isToolConfirmationPolicy = isToolConfirmationPolicy;
+exports.isToolRetrySafety = isToolRetrySafety;
+exports.isToolMetadata = isToolMetadata;
+exports.validateToolMetadata = validateToolMetadata;
+const TOOL_FAMILIES = new Set([
+    'creative',
+    'composition',
+    'artifact',
+    'memory',
+    'settings',
+    'analysis',
+    'control',
+]);
+const TOOL_EXECUTION_MODES = new Set([
+    'hosted',
+    'client',
+    'app',
+    'workflow',
+    'internal',
+]);
+const TOOL_COST_CLASSES = new Set([
+    'free',
+    'low',
+    'medium',
+    'high',
+    'variable',
+]);
+const TOOL_LATENCY_CLASSES = new Set([
+    'inline',
+    'interactive',
+    'long_running',
+]);
+const TOOL_CONFIRMATION_POLICIES = new Set(['never', 'paid', 'destructive', 'always']);
+const TOOL_RETRY_SAFETIES = new Set([
+    'idempotent',
+    'dedupe_key_required',
+    'not_safe',
+]);
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isToolFamily(value) {
+    return typeof value === 'string' && TOOL_FAMILIES.has(value);
+}
+function isToolExecutionMode(value) {
+    return typeof value === 'string' && TOOL_EXECUTION_MODES.has(value);
+}
+function isToolCostClass(value) {
+    return typeof value === 'string' && TOOL_COST_CLASSES.has(value);
+}
+function isToolLatencyClass(value) {
+    return typeof value === 'string' && TOOL_LATENCY_CLASSES.has(value);
+}
+function isToolConfirmationPolicy(value) {
+    return typeof value === 'string' && TOOL_CONFIRMATION_POLICIES.has(value);
+}
+function isToolRetrySafety(value) {
+    return typeof value === 'string' && TOOL_RETRY_SAFETIES.has(value);
+}
+function isToolMetadata(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.name !== 'string' || value.name.length === 0)
+        return false;
+    if (!isToolFamily(value.family))
+        return false;
+    if (!isToolExecutionMode(value.executionMode))
+        return false;
+    if (typeof value.inputSchemaRef !== 'string' || value.inputSchemaRef.length === 0)
+        return false;
+    if (typeof value.outputSchemaRef !== 'string' || value.outputSchemaRef.length === 0)
+        return false;
+    if (!isToolCostClass(value.costClass))
+        return false;
+    if (!isToolLatencyClass(value.latencyClass))
+        return false;
+    if (typeof value.mutatesData !== 'boolean')
+        return false;
+    if (typeof value.producesArtifacts !== 'boolean')
+        return false;
+    if (!isToolConfirmationPolicy(value.requiresConfirmation))
+        return false;
+    if (!isToolRetrySafety(value.retrySafety))
+        return false;
+    if (value.hiddenFromModel !== undefined && typeof value.hiddenFromModel !== 'boolean') {
+        return false;
+    }
+    return true;
+}
+function pushError(errors, path, message) {
+    errors.push({ path, message });
+}
+function validateToolMetadata(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        return { valid: false, errors: [{ path: '/', message: 'must be an object' }] };
+    }
+    const name = value.name;
+    if (typeof name !== 'string' || name.length === 0) {
+        pushError(errors, '/name', 'must be a non-empty string');
+    }
+    if (!isToolFamily(value.family)) {
+        pushError(errors, '/family', 'must be a valid ToolFamily');
+    }
+    if (!isToolExecutionMode(value.executionMode)) {
+        pushError(errors, '/executionMode', 'must be a valid ToolExecutionMode');
+    }
+    const inputRef = value.inputSchemaRef;
+    if (typeof inputRef !== 'string' || inputRef.length === 0) {
+        pushError(errors, '/inputSchemaRef', 'must be a non-empty string');
+    }
+    const outputRef = value.outputSchemaRef;
+    if (typeof outputRef !== 'string' || outputRef.length === 0) {
+        pushError(errors, '/outputSchemaRef', 'must be a non-empty string');
+    }
+    if (!isToolCostClass(value.costClass)) {
+        pushError(errors, '/costClass', 'must be a valid ToolCostClass');
+    }
+    if (!isToolLatencyClass(value.latencyClass)) {
+        pushError(errors, '/latencyClass', 'must be a valid ToolLatencyClass');
+    }
+    if (typeof value.mutatesData !== 'boolean') {
+        pushError(errors, '/mutatesData', 'must be a boolean');
+    }
+    if (typeof value.producesArtifacts !== 'boolean') {
+        pushError(errors, '/producesArtifacts', 'must be a boolean');
+    }
+    if (!isToolConfirmationPolicy(value.requiresConfirmation)) {
+        pushError(errors, '/requiresConfirmation', 'must be a valid ToolConfirmationPolicy');
+    }
+    if (!isToolRetrySafety(value.retrySafety)) {
+        pushError(errors, '/retrySafety', 'must be a valid ToolRetrySafety');
+    }
+    const hidden = value.hiddenFromModel;
+    if (hidden !== undefined && typeof hidden !== 'boolean') {
+        pushError(errors, '/hiddenFromModel', 'must be a boolean when present');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=toolMetadata.js.map

package/dist/agent/toolMetadata.js.map

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

package/dist/agent/turnAnalysis.d.ts

@@ -0,0 +1,34 @@
+export type TurnKind = 'chat' | 'image' | 'video' | 'audio' | 'analysis' | 'workflow' | 'memory' | 'settings' | 'unknown';
+export type TurnIntent = 'generate' | 'edit' | 'analyze' | 'transform' | 'question' | 'capability' | 'continue' | 'reference' | 'configure' | 'clarify' | 'unknown';
+export type TurnExecutionMode = 'none' | 'tool' | 'multi_tool' | 'workflow';
+export type SignalProvenance = 'classifier' | 'planner' | 'runtime_state' | 'artifact_graph' | 'user_explicit';
+export interface TurnAnalysis {
+    domain: TurnKind;
+    intent: TurnIntent;
+    executionMode: TurnExecutionMode;
+    userWantsExecution: boolean;
+    isCapabilityQuestion: boolean;
+    isFutureInstruction: boolean;
+    isReferenceOnly: boolean;
+    needsPriorContext: boolean;
+    referencedArtifacts: string[];
+    requiredCapabilities: string[];
+    needsClarification: boolean;
+    confidence: number;
+    provenance: SignalProvenance;
+}
+export declare function isTurnKind(value: unknown): value is TurnKind;
+export declare function isTurnIntent(value: unknown): value is TurnIntent;
+export declare function isTurnExecutionMode(value: unknown): value is TurnExecutionMode;
+export declare function isSignalProvenance(value: unknown): value is SignalProvenance;
+export declare function isTurnAnalysis(value: unknown): value is TurnAnalysis;
+export interface TurnAnalysisValidationError {
+    path: string;
+    message: string;
+}
+export interface TurnAnalysisValidationResult {
+    valid: boolean;
+    errors: TurnAnalysisValidationError[];
+}
+export declare function validateTurnAnalysis(value: unknown): TurnAnalysisValidationResult;
+//# sourceMappingURL=turnAnalysis.d.ts.map

package/dist/agent/turnAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnAnalysis.d.ts","sourceRoot":"","sources":["../../src/agent/turnAnalysis.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAGd,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAGd,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;AAS5E,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,SAAS,GACT,eAAe,GACf,gBAAgB,GAChB,eAAe,CAAC;AAMpB,MAAM,WAAW,YAAY;IAE3B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,iBAAiB,CAAC;IAEjC,kBAAkB,EAAE,OAAO,CAAC;IAE5B,oBAAoB,EAAE,OAAO,CAAC;IAE9B,mBAAmB,EAAE,OAAO,CAAC;IAE7B,eAAe,EAAE,OAAO,CAAC;IAEzB,iBAAiB,EAAE,OAAO,CAAC;IAE3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAE9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAE/B,kBAAkB,EAAE,OAAO,CAAC;IAE5B,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AA2CD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAUD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAgBpE;AAGD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAgBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAsDjF"}

package/dist/agent/turnAnalysis.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTurnKind = isTurnKind;
+exports.isTurnIntent = isTurnIntent;
+exports.isTurnExecutionMode = isTurnExecutionMode;
+exports.isSignalProvenance = isSignalProvenance;
+exports.isTurnAnalysis = isTurnAnalysis;
+exports.validateTurnAnalysis = validateTurnAnalysis;
+const TURN_KINDS = new Set([
+    'chat',
+    'image',
+    'video',
+    'audio',
+    'analysis',
+    'workflow',
+    'memory',
+    'settings',
+    'unknown',
+]);
+const TURN_INTENTS = new Set([
+    'generate',
+    'edit',
+    'analyze',
+    'transform',
+    'question',
+    'capability',
+    'continue',
+    'reference',
+    'configure',
+    'clarify',
+    'unknown',
+]);
+const TURN_EXECUTION_MODES = new Set([
+    'none',
+    'tool',
+    'multi_tool',
+    'workflow',
+]);
+const SIGNAL_PROVENANCES = new Set([
+    'classifier',
+    'planner',
+    'runtime_state',
+    'artifact_graph',
+    'user_explicit',
+]);
+function isTurnKind(value) {
+    return typeof value === 'string' && TURN_KINDS.has(value);
+}
+function isTurnIntent(value) {
+    return typeof value === 'string' && TURN_INTENTS.has(value);
+}
+function isTurnExecutionMode(value) {
+    return typeof value === 'string' && TURN_EXECUTION_MODES.has(value);
+}
+function isSignalProvenance(value) {
+    return typeof value === 'string' && SIGNAL_PROVENANCES.has(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isTurnAnalysis(value) {
+    if (!isRecord(value))
+        return false;
+    if (!isTurnKind(value.domain))
+        return false;
+    if (!isTurnIntent(value.intent))
+        return false;
+    if (!isTurnExecutionMode(value.executionMode))
+        return false;
+    if (typeof value.userWantsExecution !== 'boolean')
+        return false;
+    if (typeof value.isCapabilityQuestion !== 'boolean')
+        return false;
+    if (typeof value.isFutureInstruction !== 'boolean')
+        return false;
+    if (typeof value.isReferenceOnly !== 'boolean')
+        return false;
+    if (typeof value.needsPriorContext !== 'boolean')
+        return false;
+    if (!isStringArray(value.referencedArtifacts))
+        return false;
+    if (!isStringArray(value.requiredCapabilities))
+        return false;
+    if (typeof value.needsClarification !== 'boolean')
+        return false;
+    if (typeof value.confidence !== 'number' || !Number.isFinite(value.confidence))
+        return false;
+    if (!isSignalProvenance(value.provenance))
+        return false;
+    return true;
+}
+function pushError(errors, path, message) {
+    errors.push({ path, message });
+}
+function validateTurnAnalysis(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        return { valid: false, errors: [{ path: '/', message: 'must be an object' }] };
+    }
+    if (!isTurnKind(value.domain)) {
+        pushError(errors, '/domain', 'must be a valid TurnKind');
+    }
+    if (!isTurnIntent(value.intent)) {
+        pushError(errors, '/intent', 'must be a valid TurnIntent');
+    }
+    if (!isTurnExecutionMode(value.executionMode)) {
+        pushError(errors, '/executionMode', 'must be a valid TurnExecutionMode');
+    }
+    for (const key of [
+        'userWantsExecution',
+        'isCapabilityQuestion',
+        'isFutureInstruction',
+        'isReferenceOnly',
+        'needsPriorContext',
+        'needsClarification',
+    ]) {
+        if (typeof value[key] !== 'boolean') {
+            pushError(errors, `/${key}`, 'must be a boolean');
+        }
+    }
+    const refs = value.referencedArtifacts;
+    if (!Array.isArray(refs)) {
+        pushError(errors, '/referencedArtifacts', 'must be an array');
+    }
+    else {
+        refs.forEach((ref, idx) => {
+            if (typeof ref !== 'string') {
+                pushError(errors, `/referencedArtifacts/${idx}`, 'must be a string');
+            }
+        });
+    }
+    const caps = value.requiredCapabilities;
+    if (!Array.isArray(caps)) {
+        pushError(errors, '/requiredCapabilities', 'must be an array');
+    }
+    else {
+        caps.forEach((cap, idx) => {
+            if (typeof cap !== 'string') {
+                pushError(errors, `/requiredCapabilities/${idx}`, 'must be a string');
+            }
+        });
+    }
+    const conf = value.confidence;
+    if (typeof conf !== 'number' || !Number.isFinite(conf)) {
+        pushError(errors, '/confidence', 'must be a finite number');
+    }
+    if (!isSignalProvenance(value.provenance)) {
+        pushError(errors, '/provenance', 'must be a valid SignalProvenance');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=turnAnalysis.js.map

package/dist/agent/turnAnalysis.js.map

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

package/dist/agent/turnPlan.d.ts

@@ -0,0 +1,40 @@
+import { type ArtifactType } from './intentInput.js';
+export interface PlannerArtifactRef {
+    artifactId: string;
+    artifactType?: ArtifactType;
+}
+export interface PlannerProposedWorkflow {
+    templateId: string;
+    inputs: Record<string, unknown>;
+    reason?: string;
+}
+export interface PlannerSpendEstimate {
+    tokenCost: number | null;
+    usdCost: number | null;
+    estimateAvailable: boolean;
+    preferredModel?: string;
+}
+export interface TurnPlan {
+    proposedTools: string[];
+    proposedWorkflow?: PlannerProposedWorkflow;
+    resolvedReferences: PlannerArtifactRef[];
+    needsClarification?: {
+        question: string;
+    };
+    spendEstimate?: PlannerSpendEstimate;
+    confidence: number;
+}
+export declare function isPlannerArtifactRef(value: unknown): value is PlannerArtifactRef;
+export declare function isPlannerProposedWorkflow(value: unknown): value is PlannerProposedWorkflow;
+export declare function isPlannerSpendEstimate(value: unknown): value is PlannerSpendEstimate;
+export declare function isTurnPlan(value: unknown): value is TurnPlan;
+export interface TurnPlanValidationError {
+    path: string;
+    message: string;
+}
+export interface TurnPlanValidationResult {
+    valid: boolean;
+    errors: TurnPlanValidationError[];
+}
+export declare function validateTurnPlan(value: unknown): TurnPlanValidationResult;
+//# sourceMappingURL=turnPlan.d.ts.map

package/dist/agent/turnPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnPlan.d.ts","sourceRoot":"","sources":["../../src/agent/turnPlan.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQrE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAMD,MAAM,WAAW,uBAAuB;IAEtC,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,MAAM,WAAW,oBAAoB;IAKnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAIzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAKvB,iBAAiB,EAAE,OAAO,CAAC;IAK3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,MAAM,WAAW,QAAQ;IAOvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAK3C,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IAKzC,kBAAkB,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAErC,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAKhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAM1F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAYpF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAwB5D;AAGD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAoFD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAiDzE"}

package/dist/agent/turnPlan.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPlannerArtifactRef = isPlannerArtifactRef;
+exports.isPlannerProposedWorkflow = isPlannerProposedWorkflow;
+exports.isPlannerSpendEstimate = isPlannerSpendEstimate;
+exports.isTurnPlan = isTurnPlan;
+exports.validateTurnPlan = validateTurnPlan;
+const intentInput_js_1 = require("./intentInput.js");
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isPlannerArtifactRef(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.artifactId !== 'string' || value.artifactId.length === 0)
+        return false;
+    if (value.artifactType !== undefined && !(0, intentInput_js_1.isArtifactType)(value.artifactType))
+        return false;
+    return true;
+}
+function isPlannerProposedWorkflow(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.templateId !== 'string' || value.templateId.length === 0)
+        return false;
+    if (!isRecord(value.inputs))
+        return false;
+    if (value.reason !== undefined && typeof value.reason !== 'string')
+        return false;
+    return true;
+}
+function isPlannerSpendEstimate(value) {
+    if (!isRecord(value))
+        return false;
+    const { tokenCost, usdCost, estimateAvailable, preferredModel } = value;
+    if (tokenCost !== null && (typeof tokenCost !== 'number' || !Number.isFinite(tokenCost))) {
+        return false;
+    }
+    if (usdCost !== null && (typeof usdCost !== 'number' || !Number.isFinite(usdCost))) {
+        return false;
+    }
+    if (typeof estimateAvailable !== 'boolean')
+        return false;
+    if (preferredModel !== undefined && typeof preferredModel !== 'string')
+        return false;
+    return true;
+}
+function isTurnPlan(value) {
+    if (!isRecord(value))
+        return false;
+    if (!isStringArray(value.proposedTools))
+        return false;
+    if (value.proposedWorkflow !== undefined && !isPlannerProposedWorkflow(value.proposedWorkflow)) {
+        return false;
+    }
+    if (!Array.isArray(value.resolvedReferences) || !value.resolvedReferences.every(isPlannerArtifactRef)) {
+        return false;
+    }
+    if (value.needsClarification !== undefined) {
+        if (!isRecord(value.needsClarification))
+            return false;
+        if (typeof value.needsClarification.question !== 'string' ||
+            value.needsClarification.question.length === 0) {
+            return false;
+        }
+    }
+    if (value.spendEstimate !== undefined && !isPlannerSpendEstimate(value.spendEstimate)) {
+        return false;
+    }
+    if (typeof value.confidence !== 'number' || !Number.isFinite(value.confidence))
+        return false;
+    if (value.confidence < 0 || value.confidence > 1)
+        return false;
+    return true;
+}
+function pushError(errors, path, message) {
+    errors.push({ path, message });
+}
+function validateArtifactRefInternal(value, basePath, errors) {
+    if (!isRecord(value)) {
+        pushError(errors, basePath, 'must be an object');
+        return;
+    }
+    const artifactId = value.artifactId;
+    if (typeof artifactId !== 'string' || artifactId.length === 0) {
+        pushError(errors, `${basePath}/artifactId`, 'must be a non-empty string');
+    }
+    const artifactType = value.artifactType;
+    if (artifactType !== undefined && !(0, intentInput_js_1.isArtifactType)(artifactType)) {
+        pushError(errors, `${basePath}/artifactType`, 'must be a valid ArtifactType when present');
+    }
+}
+function validateProposedWorkflowInternal(value, basePath, errors) {
+    if (!isRecord(value)) {
+        pushError(errors, basePath, 'must be an object');
+        return;
+    }
+    const templateId = value.templateId;
+    if (typeof templateId !== 'string' || templateId.length === 0) {
+        pushError(errors, `${basePath}/templateId`, 'must be a non-empty string');
+    }
+    const inputs = value.inputs;
+    if (!isRecord(inputs)) {
+        pushError(errors, `${basePath}/inputs`, 'must be an object');
+    }
+    const reason = value.reason;
+    if (reason !== undefined && typeof reason !== 'string') {
+        pushError(errors, `${basePath}/reason`, 'must be a string when present');
+    }
+}
+function validateSpendEstimateInternal(value, basePath, errors) {
+    if (!isRecord(value)) {
+        pushError(errors, basePath, 'must be an object');
+        return;
+    }
+    const tokenCost = value.tokenCost;
+    if (tokenCost !== null && (typeof tokenCost !== 'number' || !Number.isFinite(tokenCost))) {
+        pushError(errors, `${basePath}/tokenCost`, 'must be a finite number or null');
+    }
+    const usdCost = value.usdCost;
+    if (usdCost !== null && (typeof usdCost !== 'number' || !Number.isFinite(usdCost))) {
+        pushError(errors, `${basePath}/usdCost`, 'must be a finite number or null');
+    }
+    if (typeof value.estimateAvailable !== 'boolean') {
+        pushError(errors, `${basePath}/estimateAvailable`, 'must be a boolean');
+    }
+    const preferredModel = value.preferredModel;
+    if (preferredModel !== undefined && typeof preferredModel !== 'string') {
+        pushError(errors, `${basePath}/preferredModel`, 'must be a string when present');
+    }
+}
+function validateTurnPlan(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        return { valid: false, errors: [{ path: '/', message: 'must be an object' }] };
+    }
+    const proposedTools = value.proposedTools;
+    if (!Array.isArray(proposedTools)) {
+        pushError(errors, '/proposedTools', 'must be an array');
+    }
+    else {
+        proposedTools.forEach((t, idx) => {
+            if (typeof t !== 'string') {
+                pushError(errors, `/proposedTools/${idx}`, 'must be a string');
+            }
+        });
+    }
+    const proposedWorkflow = value.proposedWorkflow;
+    if (proposedWorkflow !== undefined) {
+        validateProposedWorkflowInternal(proposedWorkflow, '/proposedWorkflow', errors);
+    }
+    const refs = value.resolvedReferences;
+    if (!Array.isArray(refs)) {
+        pushError(errors, '/resolvedReferences', 'must be an array');
+    }
+    else {
+        refs.forEach((ref, idx) => validateArtifactRefInternal(ref, `/resolvedReferences/${idx}`, errors));
+    }
+    const needsClarification = value.needsClarification;
+    if (needsClarification !== undefined) {
+        if (!isRecord(needsClarification)) {
+            pushError(errors, '/needsClarification', 'must be an object when present');
+        }
+        else {
+            const q = needsClarification.question;
+            if (typeof q !== 'string' || q.length === 0) {
+                pushError(errors, '/needsClarification/question', 'must be a non-empty string');
+            }
+        }
+    }
+    const spendEstimate = value.spendEstimate;
+    if (spendEstimate !== undefined) {
+        validateSpendEstimateInternal(spendEstimate, '/spendEstimate', errors);
+    }
+    const conf = value.confidence;
+    if (typeof conf !== 'number' || !Number.isFinite(conf)) {
+        pushError(errors, '/confidence', 'must be a finite number');
+    }
+    else if (conf < 0 || conf > 1) {
+        pushError(errors, '/confidence', 'must be in [0, 1]');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=turnPlan.js.map

package/dist/agent/turnPlan.js.map

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