@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/tools/auto-repair.js

@@ -0,0 +1,160 @@
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+/**
+ * Attempt to repair a malformed tool call by inferring missing/wrong params.
+ *
+ * Returns repaired arguments and a log of what was fixed.
+ * If no repairs are needed (or repair is impossible), returns the original unchanged
+ * with repaired=false.
+ *
+ * Design: never throws — always returns a result. Premium models that send
+ * correct calls pass through unchanged (zero overhead).
+ */
+export function repairToolCall(toolName, args, schema) {
+    const fixed = structuredClone(args);
+    const repairs = [];
+    try {
+        const params = schema.parameters;
+        const properties = (params?.properties ?? {});
+        const required = (params?.required ?? []);
+        // --- Rule 1: Missing `mode` on agent tool ---
+        if (toolName === 'agent' && fixed['mode'] === undefined) {
+            const inferred = _inferAgentMode(fixed);
+            if (inferred !== null) {
+                fixed['mode'] = inferred;
+                repairs.push(`inferred missing mode='${inferred}' for agent tool`);
+            }
+        }
+        // --- Rule 3 & 4 & 5: Per-property coercions ---
+        for (const [key, propSchema] of Object.entries(properties)) {
+            if (!(key in fixed)) {
+                // Property missing — handle in Rule 2 below
+                continue;
+            }
+            const value = fixed[key];
+            const expectedType = propSchema['type'];
+            const enumValues = propSchema['enum'];
+            // Rule 3: String → number coercion
+            if (expectedType === 'number' && typeof value === 'string') {
+                const coerced = Number(value);
+                if (value.trim().length > 0 && !Number.isNaN(coerced)) {
+                    fixed[key] = coerced;
+                    repairs.push(`coerced ${key} from string '${value}' to number ${coerced}`);
+                }
+                continue;
+            }
+            // Rule 4: Boolean coercion
+            if (expectedType === 'boolean' && typeof value === 'string') {
+                const lower = value.toLowerCase();
+                if (lower === 'true' || lower === 'yes') {
+                    fixed[key] = true;
+                    repairs.push(`coerced ${key} from '${value}' to boolean true`);
+                    continue;
+                }
+                if (lower === 'false' || lower === 'no') {
+                    fixed[key] = false;
+                    repairs.push(`coerced ${key} from '${value}' to boolean false`);
+                    continue;
+                }
+            }
+            // Rule 5: Enum normalization (case-insensitive match)
+            if (enumValues && typeof value === 'string') {
+                const exactMatch = enumValues.includes(value);
+                if (!exactMatch) {
+                    const lower = value.toLowerCase();
+                    const normalized = enumValues.find((e) => typeof e === 'string' && e.toLowerCase() === lower);
+                    if (normalized !== undefined) {
+                        fixed[key] = normalized;
+                        repairs.push(`normalized ${key} from '${value}' to enum value '${normalized}'`);
+                    }
+                }
+            }
+        }
+        // --- Rule 2: Missing required string params — attempt to fill from present params ---
+        for (const requiredKey of required) {
+            if (requiredKey in fixed) {
+                continue; // already present
+            }
+            const targetSchema = properties[requiredKey];
+            if (!targetSchema)
+                continue;
+            const targetType = targetSchema['type'];
+            if (targetType !== 'string') {
+                continue; // only attempt string params
+            }
+            // Look for a non-required param with the same value type whose value could fill it
+            const candidate = _findStringCandidate(requiredKey, fixed, properties, required);
+            if (candidate !== null) {
+                fixed[requiredKey] = candidate.value;
+                delete fixed[candidate.sourceKey];
+                repairs.push(`filled missing required param '${requiredKey}' from non-required param '${candidate.sourceKey}'`);
+            }
+        }
+    }
+    catch (err) {
+        // Never let repair logic crash the caller
+        logger.debug('repairToolCall: unexpected error (non-fatal)', {
+            toolName,
+            error: summarizeError(err),
+        });
+        return { repaired: false, original: args, fixed: args, repairs: [] };
+    }
+    const repaired = repairs.length > 0;
+    if (repaired) {
+        logger.debug('repairToolCall: repaired malformed tool call', {
+            toolName,
+            repairs,
+        });
+    }
+    return { repaired, original: args, fixed, repairs };
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+/**
+ * Rule 1: Infer the `mode` value for the agent tool from the supplied args.
+ */
+function _inferAgentMode(args) {
+    const hasTask = typeof args['task'] === 'string' && args['task'].length > 0;
+    const hasTemplate = typeof args['template'] === 'string';
+    const hasAgentId = typeof args['agentId'] === 'string' && args['agentId'].length > 0;
+    const isEmpty = Object.keys(args).length === 0 ||
+        Object.values(args).every((v) => v === undefined || v === null || v === '');
+    if (isEmpty) {
+        return 'list';
+    }
+    if (hasTask || hasTemplate) {
+        return 'spawn';
+    }
+    if (hasAgentId) {
+        return 'status';
+    }
+    return null;
+}
+/**
+ * Rule 2: Find a non-required string-typed param present in `args` whose
+ * value could serve as the value for the missing `targetKey`.
+ *
+ * Prefers params whose name is semantically related to the target.
+ */
+function _findStringCandidate(targetKey, args, properties, required) {
+    const nonRequiredStringArgs = Object.entries(args).filter(([key, value]) => {
+        if (required.includes(key))
+            return false; // skip required params
+        if (typeof value !== 'string' || value.length === 0)
+            return false;
+        const propType = properties[key]?.['type'];
+        // Accept if property schema says 'string' or schema doesn't define the key
+        return propType === 'string' || propType === undefined;
+    });
+    if (nonRequiredStringArgs.length === 0)
+        return null;
+    // Prefer a candidate whose key name overlaps with the target key
+    const targetLower = targetKey.toLowerCase();
+    const preferred = nonRequiredStringArgs.find(([key]) => key.toLowerCase().includes(targetLower) || targetLower.includes(key.toLowerCase()));
+    if (preferred) {
+        return { sourceKey: preferred[0], value: preferred[1] };
+    }
+    // No name match found — do not guess; let the call fail normally
+    return null;
+}

package/dist/_internal/platform/tools/control/schema.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from '../../types/tools.js';
+export declare const CONTROL_TOOL_SCHEMA: ToolDefinition;
+export interface ControlToolInput {
+    readonly mode: 'commands' | 'panels' | 'subscriptions' | 'sandbox-presets';
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/_internal/platform/tools/control/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/control/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,mBAAmB,EAAE,cAcjC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,eAAe,GAAG,iBAAiB,CAAC;CAC5E"}

package/dist/_internal/platform/tools/control/schema.js

@@ -0,0 +1,15 @@
+export const CONTROL_TOOL_SCHEMA = {
+    name: 'control',
+    description: 'Inspect packaged product-control surfaces such as commands, panels, subscriptions, and sandbox presets.',
+    parameters: {
+        type: 'object',
+        properties: {
+            mode: {
+                type: 'string',
+                enum: ['commands', 'panels', 'subscriptions', 'sandbox-presets'],
+            },
+        },
+        required: ['mode'],
+        additionalProperties: false,
+    },
+};

package/dist/_internal/platform/tools/edit/match.d.ts

@@ -0,0 +1,69 @@
+import type { EditItem, OccurrenceSpec, EditResult, EditResultStatus } from './types.js';
+export declare function decodeBase64(value: string): string;
+export declare function normalizeWhitespace(s: string): string;
+export declare function escapeRegex(s: string): string;
+export declare function findFuzzyLineMatch(content: string, findStr: string): {
+    start: number;
+    end: number;
+    similarity: number;
+    candidateLines: string[];
+} | null;
+export declare function findAllPositions(content: string, find: string, mode: 'exact' | 'fuzzy' | 'regex', caseSensitive: boolean, whitespaceSensitive?: boolean, multiline?: boolean): {
+    start: number;
+    end: number;
+}[];
+export declare function applyHints(content: string, positions: {
+    start: number;
+    end: number;
+}[], hints: EditItem['hints'], nearLine?: number): {
+    positions: {
+        start: number;
+        end: number;
+    }[];
+    warning?: string;
+};
+export declare function selectOccurrences(positions: {
+    start: number;
+    end: number;
+}[], occurrence: OccurrenceSpec | undefined): {
+    selected: {
+        start: number;
+        end: number;
+    }[];
+} | {
+    error: string;
+    hint?: string;
+};
+export declare function applyReplacements(content: string, selections: {
+    start: number;
+    end: number;
+}[], find: string, replace: string, mode: 'exact' | 'fuzzy' | 'regex', caseSensitive: boolean): string;
+export declare function computeExactEdit(fileContent: string, item: EditItem): {
+    newContent: string;
+    occurrencesReplaced: number;
+} | {
+    error: string;
+};
+export declare function computeAstEdit(fileContent: string, item: EditItem, filePath: string): Promise<{
+    newContent: string;
+    occurrencesReplaced: number;
+} | {
+    error: string;
+}>;
+export declare function computeAstPatternEdit(fileContent: string, item: EditItem, filePath: string): {
+    newContent: string;
+    occurrencesReplaced: number;
+} | {
+    error: string;
+};
+export declare function classifyEditFailure(message: string): EditResultStatus;
+export declare function buildFailedEditResult(item: EditItem, error: string, status: EditResultStatus): EditResult;
+export declare function computeSingleEdit(fileContent: string, item: EditItem, mode: 'exact' | 'fuzzy' | 'regex', caseSensitive: boolean, whitespaceSensitive?: boolean, multiline?: boolean): {
+    newContent: string;
+    occurrencesReplaced: number;
+    warning?: string;
+} | {
+    error: string;
+    hint?: string;
+};
+//# sourceMappingURL=match.d.ts.map

package/dist/_internal/platform/tools/edit/match.d.ts.map

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