@hongmaple0820/scale-engine 0.15.0 → 0.16.0

package/dist/tools/ToolOrchestrator.d.ts

@@ -0,0 +1,67 @@
+import type { SkillPlan } from '../skills/routing/index.js';
+import { type ToolCapabilityEntry, type ToolCapabilityReport } from './ToolCapabilityRegistry.js';
+import { ToolEvidenceStore, type ToolEvidenceAdapter, type ToolEvidenceStatus, type ToolRunEvidence } from './ToolEvidenceStore.js';
+import { type ResolvedToolPolicy } from './ToolPolicy.js';
+export type ToolStepStatus = 'ready' | 'missing' | 'skipped';
+export interface ToolExecutionStep {
+    id: string;
+    toolId: string;
+    domain: string;
+    adapter: ToolEvidenceAdapter;
+    required: boolean;
+    status: ToolStepStatus;
+    reason: string;
+    capability?: ToolCapabilityEntry;
+}
+export interface ToolExecutionPlan {
+    taskId: string;
+    taskName: string;
+    mode: ResolvedToolPolicy['mode'];
+    steps: ToolExecutionStep[];
+    blockers: string[];
+    warnings: string[];
+}
+export interface ToolPlanInput {
+    skillPlan: SkillPlan;
+}
+export interface ToolRunOptions {
+    dryRun?: boolean;
+    inputs?: Record<string, Record<string, unknown>>;
+}
+export interface ToolStepExecutionResult {
+    status: ToolEvidenceStatus;
+    outputSummary: string;
+    outputPaths: string[];
+    exitCode?: number;
+    version?: string;
+}
+export interface ToolRunReport {
+    taskId: string;
+    ok: boolean;
+    dryRun: boolean;
+    evidence: ToolRunEvidence[];
+    blockers: string[];
+    warnings: string[];
+}
+export interface ToolOrchestratorOptions {
+    projectDir?: string;
+    policy?: ResolvedToolPolicy;
+    capabilityReport?: ToolCapabilityReport;
+    evidenceStore?: ToolEvidenceStore;
+    executeStep?: (step: ToolExecutionStep, input: Record<string, unknown>) => Promise<ToolStepExecutionResult>;
+}
+export declare class ToolOrchestrator {
+    private projectDir;
+    private policy;
+    private capabilityReport?;
+    private evidenceStore;
+    private executeStepImpl?;
+    constructor(options?: ToolOrchestratorOptions);
+    plan(input: ToolPlanInput): ToolExecutionPlan;
+    run(plan: ToolExecutionPlan, options?: ToolRunOptions): Promise<ToolRunReport>;
+    private resolveToolIds;
+    private isRequired;
+    private resolveDomain;
+    private executeStep;
+    private safetyPolicyForStep;
+}

package/dist/tools/ToolOrchestrator.js

@@ -0,0 +1,193 @@
+import { inspectToolCapabilities, TOOL_CAPABILITY_CATALOG } from './ToolCapabilityRegistry.js';
+import { ToolEvidenceStore } from './ToolEvidenceStore.js';
+import { requiredToolsForDomains, resolveToolPolicy } from './ToolPolicy.js';
+export class ToolOrchestrator {
+    constructor(options = {}) {
+        this.projectDir = options.projectDir ?? process.cwd();
+        this.policy = options.policy ?? resolveToolPolicy(null);
+        this.capabilityReport = options.capabilityReport;
+        this.evidenceStore = options.evidenceStore ?? new ToolEvidenceStore({ projectDir: this.projectDir });
+        this.executeStepImpl = options.executeStep;
+    }
+    plan(input) {
+        if (this.policy.mode === 'off') {
+            return {
+                taskId: input.skillPlan.taskId,
+                taskName: input.skillPlan.taskName,
+                mode: this.policy.mode,
+                steps: [],
+                blockers: [],
+                warnings: ['Tool orchestration is disabled.'],
+            };
+        }
+        const toolIds = this.resolveToolIds(input.skillPlan);
+        const capabilityReport = this.capabilityReport ?? inspectToolCapabilities({
+            projectDir: this.projectDir,
+            toolIds,
+        });
+        const capabilityById = new Map(capabilityReport.tools.map(tool => [tool.id, tool]));
+        const blockers = [];
+        const warnings = [...this.policy.warnings];
+        const steps = [];
+        for (const toolId of toolIds) {
+            const capability = capabilityById.get(toolId);
+            const required = this.isRequired(toolId, input.skillPlan);
+            const status = capability?.installed ? 'ready' : 'missing';
+            const step = {
+                id: `tool-${steps.length + 1}-${toolId}`,
+                toolId,
+                domain: this.resolveDomain(toolId, input.skillPlan),
+                adapter: adapterForCategory(capability?.category ?? catalogCategory(toolId)),
+                required,
+                status,
+                capability,
+                reason: status === 'ready'
+                    ? 'Tool is available.'
+                    : capability?.missingReason ?? 'Tool capability is missing or not configured.',
+            };
+            steps.push(step);
+            if (status === 'missing' && required) {
+                const message = `Required tool ${toolId} is missing for task ${input.skillPlan.taskId}.`;
+                if (this.policy.mode === 'block')
+                    blockers.push(message);
+                else
+                    warnings.push(message);
+            }
+        }
+        return {
+            taskId: input.skillPlan.taskId,
+            taskName: input.skillPlan.taskName,
+            mode: this.policy.mode,
+            steps,
+            blockers,
+            warnings,
+        };
+    }
+    async run(plan, options = {}) {
+        const blockers = [...plan.blockers];
+        const warnings = [...plan.warnings];
+        const evidence = [];
+        if (blockers.length > 0) {
+            return {
+                taskId: plan.taskId,
+                ok: false,
+                dryRun: Boolean(options.dryRun),
+                evidence,
+                blockers,
+                warnings,
+            };
+        }
+        for (const step of plan.steps) {
+            if (step.status !== 'ready')
+                continue;
+            const result = options.dryRun
+                ? dryRunResult(step)
+                : await this.executeStep(step, options.inputs?.[step.toolId] ?? {});
+            const record = this.evidenceStore.save({
+                taskId: plan.taskId,
+                domain: step.domain,
+                tool: step.toolId,
+                adapter: step.adapter,
+                version: result.version ?? step.capability?.version,
+                command: step.capability?.command,
+                mcpToolName: step.capability?.category === 'mcp' ? step.capability.id : undefined,
+                status: result.status,
+                exitCode: result.exitCode,
+                sanitizedInput: options.inputs?.[step.toolId] ?? {},
+                outputSummary: result.outputSummary,
+                outputPaths: result.outputPaths,
+                safetyPolicy: this.safetyPolicyForStep(step, Boolean(options.dryRun)),
+            });
+            evidence.push(record);
+            if (record.status === 'failed') {
+                const message = `Tool ${step.toolId} failed for task ${plan.taskId}.`;
+                if (step.required)
+                    blockers.push(message);
+                else
+                    warnings.push(message);
+            }
+        }
+        return {
+            taskId: plan.taskId,
+            ok: blockers.length === 0,
+            dryRun: Boolean(options.dryRun),
+            evidence,
+            blockers,
+            warnings,
+        };
+    }
+    resolveToolIds(skillPlan) {
+        const requiredByDomain = requiredToolsForDomains(this.policy, skillPlan.intents.map(intent => intent.domain))
+            .map(tool => tool.id);
+        return unique([
+            ...skillPlan.requiredSkills,
+            ...requiredByDomain,
+            ...skillPlan.recommendedSkills.filter(skill => this.policy.tools[skill]?.enabled),
+        ]);
+    }
+    isRequired(toolId, skillPlan) {
+        if (skillPlan.requiredSkills.includes(toolId))
+            return true;
+        const config = this.policy.tools[toolId];
+        if (!config)
+            return false;
+        const domains = new Set(skillPlan.intents.map(intent => intent.domain));
+        return config.requiredFor.some(domain => domains.has(domain));
+    }
+    resolveDomain(toolId, skillPlan) {
+        const config = this.policy.tools[toolId];
+        const intentDomains = skillPlan.intents.map(intent => intent.domain);
+        const requiredDomain = config?.requiredFor.find(domain => intentDomains.includes(domain));
+        if (requiredDomain)
+            return requiredDomain;
+        const recommendedDomain = config?.recommendedFor?.find(domain => intentDomains.includes(domain));
+        if (recommendedDomain)
+            return recommendedDomain;
+        return intentDomains[0] ?? 'general';
+    }
+    async executeStep(step, input) {
+        if (this.executeStepImpl)
+            return this.executeStepImpl(step, input);
+        return {
+            status: 'skipped',
+            outputSummary: `No executor configured for ${step.toolId}; evidence recorded as skipped.`,
+            outputPaths: [],
+        };
+    }
+    safetyPolicyForStep(step, dryRun) {
+        const policies = ['redact-secrets'];
+        if (dryRun)
+            policies.push('dry-run');
+        if (step.adapter === 'browser')
+            policies.push('browser-side-effect-boundary');
+        if (step.adapter === 'desktop')
+            policies.push('desktop-side-effect-boundary');
+        if (step.adapter === 'cli')
+            policies.push('cli-version-and-exit-code');
+        if (step.adapter === 'mcp')
+            policies.push('mcp-tool-policy');
+        return policies;
+    }
+}
+function dryRunResult(step) {
+    return {
+        status: 'skipped',
+        outputSummary: `Dry-run: ${step.toolId} was planned but not executed.`,
+        outputPaths: [],
+        version: step.capability?.version,
+    };
+}
+function adapterForCategory(category) {
+    if (category === 'cli')
+        return 'cli';
+    if (category === 'mcp')
+        return 'mcp';
+    return 'skill';
+}
+function catalogCategory(toolId) {
+    return TOOL_CAPABILITY_CATALOG.find(tool => tool.id === toolId)?.category ?? 'skill';
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+//# sourceMappingURL=ToolOrchestrator.js.map

package/dist/tools/ToolOrchestrator.js.map

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

package/dist/tools/ToolPolicy.d.ts

@@ -0,0 +1,33 @@
+export type ToolOrchestrationMode = 'off' | 'advisory' | 'evidence-required' | 'block';
+export type ToolDestructiveActionPolicy = 'allow' | 'confirm' | 'block';
+export interface ToolPolicyToolConfig {
+    enabled: boolean;
+    requiredFor: string[];
+    recommendedFor?: string[];
+    allowedDomains?: string[];
+    destructiveActions?: ToolDestructiveActionPolicy;
+    command?: string;
+    mcpToolName?: string;
+    evidenceRequired?: boolean;
+}
+export interface ToolPolicyFile {
+    version?: number;
+    mode?: ToolOrchestrationMode;
+    tools?: Record<string, Partial<ToolPolicyToolConfig>>;
+}
+export interface ResolvedToolPolicy {
+    version: number;
+    mode: ToolOrchestrationMode;
+    tools: Record<string, ToolPolicyToolConfig>;
+    warnings: string[];
+}
+export interface RequiredTool {
+    id: string;
+    config: ToolPolicyToolConfig;
+}
+export declare const DEFAULT_TOOL_POLICY: ResolvedToolPolicy;
+export declare function toolPolicyPath(projectDir?: string, scaleDir?: string): string;
+export declare function loadToolPolicy(projectDir?: string, scaleDir?: string): ResolvedToolPolicy;
+export declare function resolveToolPolicy(input: ToolPolicyFile | null | undefined): ResolvedToolPolicy;
+export declare function requiredToolsForDomains(policy: ResolvedToolPolicy, domains: string[]): RequiredTool[];
+export declare function toolPolicyTemplate(mode?: ToolOrchestrationMode): string;

package/dist/tools/ToolPolicy.js

@@ -0,0 +1,157 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+export const DEFAULT_TOOL_POLICY = {
+    version: 1,
+    mode: 'evidence-required',
+    warnings: [],
+    tools: {
+        'web-access': {
+            enabled: true,
+            requiredFor: ['webResearch'],
+            recommendedFor: ['browserAutomation'],
+            destructiveActions: 'block',
+            evidenceRequired: true,
+        },
+        'frontend-design': {
+            enabled: true,
+            requiredFor: ['ui'],
+            destructiveActions: 'block',
+            evidenceRequired: true,
+        },
+        'ui-ux-pro-max': {
+            enabled: true,
+            requiredFor: ['ui'],
+            destructiveActions: 'block',
+            evidenceRequired: true,
+        },
+        'agent-browser': {
+            enabled: true,
+            requiredFor: ['browserAutomation'],
+            recommendedFor: ['ui', 'e2e'],
+            allowedDomains: ['localhost', '127.0.0.1'],
+            destructiveActions: 'confirm',
+            command: 'agent-browser',
+            evidenceRequired: true,
+        },
+        playwright: {
+            enabled: true,
+            requiredFor: ['e2e'],
+            recommendedFor: ['browserAutomation', 'ui'],
+            destructiveActions: 'confirm',
+            command: 'npx playwright',
+            evidenceRequired: true,
+        },
+        'mcp-chrome-devtools': {
+            enabled: true,
+            requiredFor: ['browserAutomation'],
+            recommendedFor: ['ui', 'e2e'],
+            destructiveActions: 'confirm',
+            mcpToolName: 'chrome-devtools',
+            evidenceRequired: true,
+        },
+        'desktop-cua': {
+            enabled: false,
+            requiredFor: ['desktopAutomation'],
+            destructiveActions: 'block',
+            command: 'cua',
+            evidenceRequired: true,
+        },
+        'codex-cli': {
+            enabled: false,
+            requiredFor: [],
+            recommendedFor: ['externalCli', 'review'],
+            destructiveActions: 'block',
+            command: 'codex',
+            evidenceRequired: true,
+        },
+        'gemini-cli': {
+            enabled: false,
+            requiredFor: [],
+            recommendedFor: ['externalCli', 'review'],
+            destructiveActions: 'block',
+            command: 'gemini',
+            evidenceRequired: true,
+        },
+        'opencode-cli': {
+            enabled: false,
+            requiredFor: [],
+            recommendedFor: ['externalCli', 'review'],
+            destructiveActions: 'block',
+            command: 'opencode',
+            evidenceRequired: true,
+        },
+    },
+};
+export function toolPolicyPath(projectDir = process.cwd(), scaleDir = '.scale') {
+    const root = isAbsolute(scaleDir) ? scaleDir : join(resolve(projectDir), scaleDir);
+    return join(root, 'tools.json');
+}
+export function loadToolPolicy(projectDir = process.cwd(), scaleDir = '.scale') {
+    const path = toolPolicyPath(projectDir, scaleDir);
+    if (!existsSync(path)) {
+        return {
+            ...DEFAULT_TOOL_POLICY,
+            warnings: [`No tool policy found at ${path}; using built-in defaults.`],
+        };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return resolveToolPolicy(parsed);
+    }
+    catch (error) {
+        return {
+            ...DEFAULT_TOOL_POLICY,
+            warnings: [`Failed to read ${path}: ${error.message}; using built-in defaults.`],
+        };
+    }
+}
+export function resolveToolPolicy(input) {
+    const warnings = [];
+    const mode = normalizeMode(input?.mode);
+    if (input?.mode && !mode) {
+        warnings.push(`Invalid tool policy mode "${String(input.mode)}"; using ${DEFAULT_TOOL_POLICY.mode}.`);
+    }
+    const tools = {};
+    const ids = new Set([...Object.keys(DEFAULT_TOOL_POLICY.tools), ...Object.keys(input?.tools ?? {})]);
+    for (const id of ids) {
+        const base = DEFAULT_TOOL_POLICY.tools[id] ?? {
+            enabled: true,
+            requiredFor: [],
+            destructiveActions: 'confirm',
+            evidenceRequired: true,
+        };
+        const override = input?.tools?.[id] ?? {};
+        tools[id] = {
+            ...base,
+            ...override,
+            requiredFor: override.requiredFor ?? base.requiredFor ?? [],
+            recommendedFor: override.recommendedFor ?? base.recommendedFor,
+            allowedDomains: override.allowedDomains ?? base.allowedDomains,
+        };
+    }
+    return {
+        version: typeof input?.version === 'number' ? input.version : DEFAULT_TOOL_POLICY.version,
+        mode: mode ?? DEFAULT_TOOL_POLICY.mode,
+        tools,
+        warnings,
+    };
+}
+export function requiredToolsForDomains(policy, domains) {
+    const domainSet = new Set(domains);
+    return Object.entries(policy.tools)
+        .filter(([, config]) => config.enabled && config.requiredFor.some(domain => domainSet.has(domain)))
+        .map(([id, config]) => ({ id, config }));
+}
+export function toolPolicyTemplate(mode = 'evidence-required') {
+    return JSON.stringify({
+        version: 1,
+        mode,
+        tools: DEFAULT_TOOL_POLICY.tools,
+    }, null, 2) + '\n';
+}
+function normalizeMode(value) {
+    if (value === 'off' || value === 'advisory' || value === 'evidence-required' || value === 'block')
+        return value;
+    return undefined;
+}
+//# sourceMappingURL=ToolPolicy.js.map

package/dist/tools/ToolPolicy.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ToolPolicy.js';
+export * from './ToolEvidenceStore.js';
+export * from './ToolCapabilityRegistry.js';
+export * from './ToolOrchestrator.js';
+export * from './ToolEvidenceGate.js';

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+export * from './ToolPolicy.js';
+export * from './ToolEvidenceStore.js';
+export * from './ToolCapabilityRegistry.js';
+export * from './ToolOrchestrator.js';
+export * from './ToolEvidenceGate.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const FALLBACK_SCALE_ENGINE_VERSION = "0.15.1";
+export declare function getScaleEngineVersion(): string;
+export declare const SCALE_ENGINE_VERSION: string;

package/dist/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from 'node:fs';
+export const FALLBACK_SCALE_ENGINE_VERSION = '0.15.1';
+export function getScaleEngineVersion() {
+    try {
+        const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+        return typeof packageJson.version === 'string' && packageJson.version.trim()
+            ? packageJson.version
+            : FALLBACK_SCALE_ENGINE_VERSION;
+    }
+    catch {
+        return FALLBACK_SCALE_ENGINE_VERSION;
+    }
+}
+export const SCALE_ENGINE_VERSION = getScaleEngineVersion();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,CAAC,MAAM,6BAA6B,GAAG,QAAQ,CAAA;AAErD,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAC1C,CAAA;QAC1B,OAAO,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE;YAC1E,CAAC,CAAC,WAAW,CAAC,OAAO;YACrB,CAAC,CAAC,6BAA6B,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6BAA6B,CAAA;IACtC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,EAAE,CAAA"}