turboflux 1.0.0

package/dist/core/schemaValidation.js

@@ -0,0 +1,153 @@
+export function validateSchemaValue(schema, value, path = '') {
+    return validateSchemaValueInternal(schema, value, path, {
+        rootSchema: schema,
+        activeRefs: new Set(),
+    });
+}
+function validateSchemaValueInternal(schema, value, path, context) {
+    const location = path || 'arguments';
+    if (typeof schema.$ref === 'string') {
+        const ref = schema.$ref;
+        if (context.activeRefs.has(ref)) {
+            return { valid: false, error: `Invalid schema reference for ${location}: circular $ref ${ref}` };
+        }
+        const resolved = resolveLocalRef(context.rootSchema, ref);
+        if (!resolved) {
+            return { valid: false, error: `Invalid schema reference for ${location}: ${ref}` };
+        }
+        context.activeRefs.add(ref);
+        const result = validateSchemaValueInternal(resolved, value, path, context);
+        context.activeRefs.delete(ref);
+        if (!result.valid)
+            return result;
+    }
+    if (Array.isArray(schema.allOf)) {
+        for (const candidate of schema.allOf) {
+            if (!candidate || typeof candidate !== 'object') {
+                return { valid: false, error: `Invalid schema for ${location}: allOf entries must be objects` };
+            }
+            const result = validateSchemaValueInternal(candidate, value, path, context);
+            if (!result.valid)
+                return result;
+        }
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const accepted = schema.anyOf.some(candidate => candidate && typeof candidate === 'object'
+            && validateSchemaValueInternal(candidate, value, path, context).valid);
+        if (!accepted)
+            return { valid: false, error: `Invalid value for ${location}: no schema alternative matched` };
+    }
+    if (Array.isArray(schema.oneOf)) {
+        const matches = schema.oneOf.filter(candidate => candidate && typeof candidate === 'object'
+            && validateSchemaValueInternal(candidate, value, path, context).valid).length;
+        if (matches !== 1) {
+            return { valid: false, error: `Invalid value for ${location}: expected exactly one schema alternative to match` };
+        }
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some(candidate => Object.is(candidate, value))) {
+        return { valid: false, error: `Invalid value for ${location}: expected one of ${schema.enum.map(String).join(', ')}` };
+    }
+    const declaredTypes = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+    if (declaredTypes.length > 0 && !declaredTypes.some(type => schemaTypeMatches(String(type), value))) {
+        return { valid: false, error: `Invalid type for ${location}: expected ${declaredTypes.join(' or ')}` };
+    }
+    if (typeof value === 'string') {
+        if (typeof schema.minLength === 'number' && value.length < schema.minLength) {
+            return { valid: false, error: `Invalid value for ${location}: expected at least ${schema.minLength} characters` };
+        }
+        if (typeof schema.maxLength === 'number' && value.length > schema.maxLength) {
+            return { valid: false, error: `Invalid value for ${location}: expected at most ${schema.maxLength} characters` };
+        }
+        if (typeof schema.pattern === 'string') {
+            try {
+                if (!new RegExp(schema.pattern).test(value)) {
+                    return { valid: false, error: `Invalid value for ${location}: does not match the required pattern` };
+                }
+            }
+            catch {
+                return { valid: false, error: `Invalid schema pattern for ${location}` };
+            }
+        }
+    }
+    if (typeof value === 'number') {
+        if (typeof schema.minimum === 'number' && value < schema.minimum) {
+            return { valid: false, error: `Invalid value for ${location}: expected at least ${schema.minimum}` };
+        }
+        if (typeof schema.maximum === 'number' && value > schema.maximum) {
+            return { valid: false, error: `Invalid value for ${location}: expected at most ${schema.maximum}` };
+        }
+    }
+    if (Array.isArray(value)) {
+        if (typeof schema.minItems === 'number' && value.length < schema.minItems) {
+            return { valid: false, error: `Invalid value for ${location}: expected at least ${schema.minItems} item(s)` };
+        }
+        if (typeof schema.maxItems === 'number' && value.length > schema.maxItems) {
+            return { valid: false, error: `Invalid value for ${location}: expected at most ${schema.maxItems} item(s)` };
+        }
+        if (schema.items && typeof schema.items === 'object') {
+            for (let index = 0; index < value.length; index += 1) {
+                const result = validateSchemaValueInternal(schema.items, value[index], `${location}[${index}]`, context);
+                if (!result.valid)
+                    return result;
+            }
+        }
+    }
+    const isObjectSchema = declaredTypes.includes('object') || (!schema.type && schema.properties && typeof schema.properties === 'object');
+    if (isObjectSchema && value && typeof value === 'object' && !Array.isArray(value)) {
+        const record = value;
+        const properties = schema.properties && typeof schema.properties === 'object'
+            ? schema.properties
+            : {};
+        const required = Array.isArray(schema.required)
+            ? schema.required.filter((name) => typeof name === 'string')
+            : [];
+        for (const name of required) {
+            if (record[name] === undefined || record[name] === null) {
+                return { valid: false, error: `Missing required parameter: ${path ? `${path}.` : ''}${name}` };
+            }
+        }
+        if (schema.additionalProperties === false) {
+            const unexpected = Object.keys(record).find(name => !(name in properties));
+            if (unexpected)
+                return { valid: false, error: `Unexpected parameter: ${path ? `${path}.` : ''}${unexpected}` };
+        }
+        for (const [name, propertySchema] of Object.entries(properties)) {
+            if (record[name] === undefined || !propertySchema || typeof propertySchema !== 'object')
+                continue;
+            const result = validateSchemaValueInternal(propertySchema, record[name], path ? `${path}.${name}` : name, context);
+            if (!result.valid)
+                return result;
+        }
+    }
+    return { valid: true };
+}
+function resolveLocalRef(rootSchema, ref) {
+    if (!ref.startsWith('#/'))
+        return null;
+    const parts = ref
+        .slice(2)
+        .split('/')
+        .map(part => part.replace(/~1/g, '/').replace(/~0/g, '~'));
+    let cursor = rootSchema;
+    for (const part of parts) {
+        if (!cursor || typeof cursor !== 'object' || Array.isArray(cursor) || !(part in cursor))
+            return null;
+        cursor = cursor[part];
+    }
+    return cursor && typeof cursor === 'object' && !Array.isArray(cursor)
+        ? cursor
+        : null;
+}
+function schemaTypeMatches(type, value) {
+    switch (type) {
+        case 'null': return value === null;
+        case 'string': return typeof value === 'string';
+        case 'number': return typeof value === 'number' && Number.isFinite(value);
+        case 'integer': return typeof value === 'number' && Number.isInteger(value);
+        case 'boolean': return typeof value === 'boolean';
+        case 'array': return Array.isArray(value);
+        case 'object': return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+        default: return true;
+    }
+}
+//# sourceMappingURL=schemaValidation.js.map

package/dist/core/schemaValidation.js.map

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

package/dist/core/skills/loader.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '../../shared/skillTypes';
+export interface LoadedSkill extends Skill {
+    source: 'system';
+    filePath: string;
+    rawContent: string;
+}
+export declare function loadAllSkills(workspacePath: string): LoadedSkill[];

package/dist/core/skills/loader.js

@@ -0,0 +1,91 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: content };
+    const yamlBlock = match[1];
+    const body = match[2];
+    const meta = {};
+    for (const line of yamlBlock.split('\n')) {
+        const kv = line.match(/^(\w+):\s*(.+)$/);
+        if (!kv)
+            continue;
+        const [, key, value] = kv;
+        if (key === 'allowedTools') {
+            try {
+                meta.allowedTools = JSON.parse(value);
+            }
+            catch {
+                meta.allowedTools = value.replace(/[\[\]]/g, '').split(',').map(s => s.trim());
+            }
+        }
+        else {
+            meta[key] = value.trim();
+        }
+    }
+    return { meta, body };
+}
+function loadSkillFromDir(dirPath, source) {
+    const skillFile = join(dirPath, 'SKILL.md');
+    if (!existsSync(skillFile))
+        return null;
+    try {
+        const rawContent = readFileSync(skillFile, 'utf-8');
+        const { meta, body } = parseFrontmatter(rawContent);
+        const dirName = dirPath.split(/[\\/]/).pop() || 'unknown';
+        return {
+            id: meta.name || dirName,
+            name: meta.name || dirName,
+            command: `/${meta.name || dirName}`,
+            description: meta.description || '',
+            category: meta.category || 'custom',
+            icon: meta.icon,
+            systemPrompt: body.trim(),
+            source,
+            filePath: skillFile,
+            rawContent,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function scanDirectory(basePath, source) {
+    if (!existsSync(basePath))
+        return [];
+    const skills = [];
+    try {
+        const entries = readdirSync(basePath);
+        for (const entry of entries) {
+            const fullPath = join(basePath, entry);
+            if (statSync(fullPath).isDirectory()) {
+                const skill = loadSkillFromDir(fullPath, source);
+                if (skill)
+                    skills.push(skill);
+            }
+        }
+    }
+    catch {
+    }
+    return skills;
+}
+export function loadAllSkills(workspacePath) {
+    const projectSkills = scanDirectory(join(workspacePath, '.turboflux', 'skills'), 'system');
+    const userSkills = scanDirectory(join(homedir(), '.turboflux', 'skills'), 'system');
+    const seen = new Set();
+    const result = [];
+    for (const skill of projectSkills) {
+        seen.add(skill.id);
+        result.push(skill);
+    }
+    for (const skill of userSkills) {
+        if (!seen.has(skill.id)) {
+            seen.add(skill.id);
+            result.push(skill);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/skills/loader.js.map

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

package/dist/core/skills/runtime.d.ts

@@ -0,0 +1,19 @@
+import type { AgentEngine } from '../agentEngine';
+import type { LoadedSkill } from './loader';
+export type SkillSource = 'system';
+export declare class SkillRuntime {
+    private workspacePath;
+    private skills;
+    private activeSkillId;
+    constructor(workspacePath: string);
+    reload(): void;
+    registerSkill(skill: LoadedSkill): void;
+    registerSkills(skills: LoadedSkill[]): void;
+    getAll(): LoadedSkill[];
+    getById(id: string): LoadedSkill | undefined;
+    getByCommand(command: string): LoadedSkill | undefined;
+    activate(skillId: string, engine: AgentEngine): boolean;
+    deactivate(engine: AgentEngine): void;
+    getActiveSkillId(): string | null;
+    getSkillPrompt(skillId: string): string | null;
+}

package/dist/core/skills/runtime.js

@@ -0,0 +1,61 @@
+import { loadAllSkills } from './loader';
+export class SkillRuntime {
+    workspacePath;
+    skills = [];
+    activeSkillId = null;
+    constructor(workspacePath) {
+        this.workspacePath = workspacePath;
+        this.reload();
+    }
+    reload() {
+        this.skills = loadAllSkills(this.workspacePath);
+    }
+    registerSkill(skill) {
+        const idx = this.skills.findIndex(s => s.id === skill.id);
+        if (idx >= 0) {
+            this.skills[idx] = skill;
+        }
+        else {
+            this.skills.push(skill);
+        }
+    }
+    registerSkills(skills) {
+        for (const skill of skills) {
+            this.registerSkill(skill);
+        }
+    }
+    getAll() {
+        return this.skills;
+    }
+    getById(id) {
+        return this.skills.find(s => s.id === id);
+    }
+    getByCommand(command) {
+        const normalized = command.startsWith('/') ? command : `/${command}`;
+        return this.skills.find(s => s.command === normalized);
+    }
+    activate(skillId, engine) {
+        const skill = this.getById(skillId);
+        if (!skill)
+            return false;
+        this.activeSkillId = skillId;
+        if (skill.systemPrompt) {
+            engine.setAppendSystemPrompt(skill.systemPrompt);
+        }
+        return true;
+    }
+    deactivate(engine) {
+        this.activeSkillId = null;
+        engine.setAppendSystemPrompt(undefined);
+    }
+    getActiveSkillId() {
+        return this.activeSkillId;
+    }
+    getSkillPrompt(skillId) {
+        const skill = this.getById(skillId);
+        if (!skill?.systemPrompt)
+            return null;
+        return skill.systemPrompt;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/skills/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/core/skills/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAKxC,MAAM,OAAO,YAAY;IAIH;IAHZ,MAAM,GAAkB,EAAE,CAAA;IAC1B,aAAa,GAAkB,IAAI,CAAA;IAE3C,YAAoB,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;QACvC,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACjD,CAAC;IAMD,aAAa,CAAC,KAAkB;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAA;QACzD,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAKD,cAAc,CAAC,MAAqB;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAA;QACpE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAA;IACxD,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,MAAmB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QAExB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC5B,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU,CAAC,MAAmB;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,OAAO,IAAI,CAAA;QACrC,OAAO,KAAK,CAAC,YAAY,CAAA;IAC3B,CAAC;CACF"}

package/dist/core/subAgent.d.ts

@@ -0,0 +1,50 @@
+import type { SubAgentEvent, SubAgentEvidence, SubAgentDefinition } from '../shared/subAgentTypes';
+import type { NativeReasoningConfig } from '../shared/agentTypes';
+import type { ToolExecutor } from '../tools/executor';
+import type { ModelCapabilities } from './config';
+import type { SkillRuntime } from './skills/runtime';
+export { type SubAgentDefinition };
+export declare function loadDynamicAgents(workspacePath: string): void;
+export declare function registerAgent(def: SubAgentDefinition, skillRuntime?: SkillRuntime): void;
+export declare function getSubAgentDefinition(type: string): SubAgentDefinition | undefined;
+export declare function getAllAgentDefinitions(): SubAgentDefinition[];
+export declare function getAvailableAgentTypes(): string[];
+export declare function syncAgentSkills(skillRuntime: SkillRuntime): void;
+export interface RunSubAgentOptions {
+    definition: SubAgentDefinition;
+    objective: string;
+    workspacePath: string;
+    toolExecutor: ToolExecutor;
+    apiKey: string;
+    baseUrl: string;
+    provider?: string;
+    customHeaders?: Record<string, string>;
+    reasoning?: NativeReasoningConfig;
+    modelCapabilities?: ModelCapabilities;
+    model?: string;
+    codemap?: string | null;
+    abortSignal?: AbortSignal;
+    requestTimeoutMs?: number;
+    requestAttemptTimeoutMs?: number;
+    maxTransientAttempts?: number;
+    userPrompt?: string;
+    allowedTools?: string[];
+    onEvent?: (event: SubAgentEvent) => void;
+}
+export interface SubAgentResult {
+    ok: boolean;
+    turns: number;
+    elapsedMs: number;
+    finalText?: string;
+    evidence?: SubAgentEvidence[];
+    error?: string;
+    truncated?: boolean;
+}
+export declare function __testClearSubAgentProtocolCache(): void;
+export declare function runSubAgent(options: RunSubAgentOptions): Promise<SubAgentResult>;
+export declare function __testTraceDefinitionReadLimit(hit: {
+    startLine?: number;
+    endLine?: number;
+    line?: number;
+    symbolKind?: string;
+}): number;