takt 0.35.4 → 0.37.0

package/dist/infra/config/loaders/workflowParser.js

@@ -0,0 +1,107 @@
+/**
+ * Workflow YAML parsing and normalization.
+ */
+import { WorkflowConfigRawSchema } from '../../../core/models/index.js';
+import { resolveLoopMonitorJudgeProviderModel, resolveStepProviderModel } from '../../../core/workflow/provider-resolution.js';
+import { validateProviderModelCompatibility } from '../../../core/workflow/provider-model-compatibility.js';
+import { isPathSafe } from '../paths.js';
+import { normalizeRuntime } from '../configNormalizers.js';
+import { resolveSectionMap } from './resource-resolver.js';
+import { validateWorkflowRuntimePrepare, } from './workflowNormalizationPolicies.js';
+import { normalizeLoopMonitors } from './workflowLoopMonitorNormalizer.js';
+import { normalizeProviderReference, normalizeStepFromRaw } from './workflowStepNormalizer.js';
+import { expandCallableSubworkflowRaw, } from './workflowCallableArgResolver.js';
+import { prepareCallableSubworkflowDiscoveryArgs } from './workflowCallableDiscoveryArgs.js';
+import { validateProjectWorkflowTrustBoundaryForSteps } from './workflowTrustBoundary.js';
+import { getWorkflowPathTrustInfo } from './workflowTrustSource.js';
+function normalizeSubworkflowConfig(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    return {
+        callable: raw.callable,
+        visibility: raw.visibility,
+        returns: raw.returns,
+        params: raw.params
+            ? Object.fromEntries(Object.entries(raw.params).map(([name, param]) => [
+                name,
+                {
+                    type: param.type,
+                    facetKind: param.facet_kind,
+                    default: param.default,
+                },
+            ]))
+            : undefined,
+    };
+}
+export function normalizeWorkflowConfig(raw, workflowDir, context, projectOverrides, globalOverrides, workflowRuntimePreparePolicy, workflowArpeggioPolicy, workflowMcpServersPolicy, workflowPath = workflowDir, trustInfo, callableArgs, callableArgPolicy, callableArgMode = 'runtime') {
+    const parsedRaw = WorkflowConfigRawSchema.parse(raw);
+    const callableDiscovery = callableArgMode === 'discovery'
+        ? prepareCallableSubworkflowDiscoveryArgs(parsedRaw)
+        : { raw: parsedRaw, callableArgs };
+    const parsed = expandCallableSubworkflowRaw(callableDiscovery.raw, {
+        args: callableDiscovery.callableArgs ?? callableArgs,
+        argPolicy: callableArgPolicy,
+        workflowDir,
+        context,
+    });
+    const sections = {
+        personas: parsed.personas,
+        resolvedPolicies: resolveSectionMap(parsed.policies, workflowDir),
+        resolvedKnowledge: resolveSectionMap(parsed.knowledge, workflowDir),
+        resolvedInstructions: resolveSectionMap(parsed.instructions, workflowDir),
+        resolvedReportFormats: resolveSectionMap(parsed.report_formats, workflowDir),
+    };
+    const workflowRuntime = normalizeRuntime(parsed.workflow_config?.runtime);
+    validateWorkflowRuntimePrepare(workflowRuntime, workflowRuntimePreparePolicy);
+    const normalizedWorkflowProvider = normalizeProviderReference(parsed.workflow_config?.provider, parsed.workflow_config?.model, parsed.workflow_config?.provider_options);
+    if (trustInfo?.isProjectTrustRoot) {
+        validateProjectWorkflowTrustBoundaryForSteps(parsed.steps, workflowPath, trustInfo);
+    }
+    else if (context?.projectDir && isPathSafe(context.projectDir, workflowDir)) {
+        validateProjectWorkflowTrustBoundaryForSteps(parsed.steps, workflowPath, getWorkflowPathTrustInfo(workflowPath, context.projectDir));
+    }
+    const steps = parsed.steps.map((step) => normalizeStepFromRaw(step, workflowDir, sections, parsed.schemas, normalizedWorkflowProvider.provider, normalizedWorkflowProvider.model, normalizedWorkflowProvider.providerOptions, context, projectOverrides, globalOverrides, workflowArpeggioPolicy, workflowMcpServersPolicy));
+    const loopMonitors = normalizeLoopMonitors(parsed.loop_monitors, workflowDir, sections, context);
+    for (const monitor of loopMonitors ?? []) {
+        const triggeringStep = steps.find((step) => step.name === monitor.cycle[monitor.cycle.length - 1]);
+        if (!triggeringStep) {
+            continue;
+        }
+        const triggeringProviderInfo = resolveStepProviderModel({
+            step: triggeringStep,
+            provider: normalizedWorkflowProvider.provider,
+            model: normalizedWorkflowProvider.model,
+        });
+        const judgeProviderInfo = resolveLoopMonitorJudgeProviderModel({
+            judge: monitor.judge,
+            triggeringStep,
+            provider: triggeringProviderInfo.provider,
+            model: triggeringProviderInfo.model,
+        });
+        validateProviderModelCompatibility(judgeProviderInfo.provider, judgeProviderInfo.model, {
+            modelFieldName: 'Configuration error: loop_monitors.judge.model',
+        });
+    }
+    return {
+        name: parsed.name,
+        description: parsed.description,
+        subworkflow: normalizeSubworkflowConfig(parsed.subworkflow),
+        schemas: parsed.schemas,
+        provider: normalizedWorkflowProvider.provider,
+        model: normalizedWorkflowProvider.model,
+        providerOptions: normalizedWorkflowProvider.providerOptions,
+        runtime: workflowRuntime,
+        personas: parsed.personas,
+        policies: sections.resolvedPolicies,
+        knowledge: sections.resolvedKnowledge,
+        instructions: sections.resolvedInstructions,
+        reportFormats: sections.resolvedReportFormats,
+        steps,
+        initialStep: parsed.initial_step ?? steps[0].name,
+        maxSteps: parsed.max_steps,
+        loopMonitors,
+        interactiveMode: parsed.interactive_mode,
+    };
+}
+//# sourceMappingURL=workflowParser.js.map

package/dist/infra/config/loaders/workflowParser.js.map

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

package/dist/infra/config/loaders/workflowPersonaPathPolicy.d.ts

@@ -0,0 +1,3 @@
+import { type FacetResolutionContext } from './workflowPackageScope.js';
+export declare function assertAllowedPersonaPath(personaPath: string, context?: FacetResolutionContext): void;
+//# sourceMappingURL=workflowPersonaPathPolicy.d.ts.map

package/dist/infra/config/loaders/workflowPersonaPathPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowPersonaPathPolicy.d.ts","sourceRoot":"","sources":["../../../../src/infra/config/loaders/workflowPersonaPathPolicy.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiD,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAiDvH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAapG"}

package/dist/infra/config/loaders/workflowPersonaPathPolicy.js

@@ -0,0 +1,43 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { getBuiltinFacetDir, getGlobalConfigDir, getGlobalFacetDir, getProjectConfigDir, getProjectFacetDir, getRepertoireFacetDir, getRepertoirePackageDir, isPathSafe, } from '../paths.js';
+import { getPackageFromWorkflowDir, getWorkflowBaseDir } from './workflowPackageScope.js';
+function getWorkflowPersonaBases(context) {
+    const bases = [
+        getBuiltinFacetDir(context.lang, 'personas'),
+        getGlobalFacetDir('personas'),
+        join(getGlobalConfigDir(), 'personas'),
+        join(getGlobalConfigDir(), 'agents'),
+    ];
+    if (context.projectDir) {
+        const projectConfigDir = getProjectConfigDir(context.projectDir);
+        bases.push(join(context.projectDir, 'personas'), join(context.projectDir, 'agents'), join(projectConfigDir, 'personas'), join(projectConfigDir, 'agents'), getProjectFacetDir(context.projectDir, 'personas'));
+    }
+    if (context.workflowDir) {
+        const workflowBaseDir = getWorkflowBaseDir(context.workflowDir);
+        const workflowParentDir = dirname(workflowBaseDir);
+        bases.push(workflowBaseDir, join(workflowBaseDir, 'personas'), join(workflowBaseDir, 'agents'), join(workflowParentDir, 'personas'), join(workflowParentDir, 'agents'));
+    }
+    if (context.workflowDir && context.repertoireDir) {
+        const workflowBaseDir = getWorkflowBaseDir(context.workflowDir);
+        const pkg = getPackageFromWorkflowDir(workflowBaseDir, context.repertoireDir);
+        if (pkg) {
+            const packageDir = getRepertoirePackageDir(pkg.owner, pkg.repo);
+            bases.push(join(packageDir, 'personas'), join(packageDir, 'agents'), getRepertoireFacetDir(pkg.owner, pkg.repo, 'personas', context.repertoireDir));
+        }
+    }
+    return bases;
+}
+export function assertAllowedPersonaPath(personaPath, context) {
+    if (!context) {
+        return;
+    }
+    const isAllowed = getWorkflowPersonaBases(context).some((base) => isPathSafe(base, personaPath));
+    if (!isAllowed) {
+        throw new Error(`Persona prompt file path is not allowed: ${personaPath}`);
+    }
+    if (!existsSync(personaPath)) {
+        throw new Error(`Persona prompt file not found: ${personaPath}`);
+    }
+}
+//# sourceMappingURL=workflowPersonaPathPolicy.js.map

package/dist/infra/config/loaders/workflowPersonaPathPolicy.js.map

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

package/dist/infra/config/loaders/workflowPreview.d.ts

@@ -0,0 +1,23 @@
+import type { InteractiveMode } from '../../../core/models/index.js';
+export interface StepPreview {
+    name: string;
+    personaDisplayName: string;
+    personaContent: string;
+    instructionContent: string;
+    allowedTools: string[];
+    canEdit: boolean;
+}
+export interface FirstStepInfo {
+    personaContent: string;
+    personaDisplayName: string;
+    allowedTools: string[];
+}
+export declare function getWorkflowDescription(identifier: string, projectCwd: string, previewCount?: number, lookupCwd?: string): {
+    name: string;
+    description: string;
+    workflowStructure: string;
+    stepPreviews: StepPreview[];
+    interactiveMode?: InteractiveMode;
+    firstStep?: FirstStepInfo;
+};
+//# sourceMappingURL=workflowPreview.d.ts.map

package/dist/infra/config/loaders/workflowPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowPreview.d.ts","sourceRoot":"","sources":["../../../../src/infra/config/loaders/workflowPreview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,+BAA+B,CAAC;AAiBnG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAqID,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,SAAa,GACrB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAgBA"}

package/dist/infra/config/loaders/workflowPreview.js

@@ -0,0 +1,113 @@
+import { resolveStepProviderModel } from '../../../core/workflow/provider-resolution.js';
+import { assertProviderResolvedForCapabilitySensitiveOptions, resolveAllowedToolsForProvider, } from '../../../core/workflow/engine/engine-provider-options.js';
+import { createLogger, getErrorMessage } from '../../../shared/utils/index.js';
+import { resolveWorkflowConfigValues } from '../resolveWorkflowConfigValue.js';
+import { resolveProviderOptionsWithTrace } from '../resolveConfigValue.js';
+import { resolveEffectiveProviderOptions } from '../providerOptions.js';
+import { loadPersonaPromptFromPath } from './agentLoader.js';
+import { loadWorkflowByIdentifier } from './workflowResolver.js';
+const log = createLogger('workflow-preview');
+function buildWorkflowString(steps) {
+    const lines = [];
+    let index = 1;
+    for (const step of steps) {
+        lines.push(`${index}. ${step.name}${step.description ? ` (${step.description})` : ''}`);
+        for (const sub of step.parallel ?? []) {
+            lines.push(`   - ${sub.name}${sub.description ? ` (${sub.description})` : ''}`);
+        }
+        index++;
+    }
+    return lines.join('\n');
+}
+function readStepPersona(step, projectCwd) {
+    if (!step.personaPath) {
+        return step.persona ?? '';
+    }
+    try {
+        return loadPersonaPromptFromPath(step.personaPath, projectCwd);
+    }
+    catch (error) {
+        log.debug('Failed to read persona file', { path: step.personaPath, error: getErrorMessage(error) });
+        return '';
+    }
+}
+function resolvePreviewProviderResolution(projectCwd) {
+    const { provider, model, personaProviders, } = resolveWorkflowConfigValues(projectCwd, ['provider', 'model', 'personaProviders']);
+    const { value: providerOptions, source: providerOptionsSource, originResolver: providerOptionsOriginResolver, } = resolveProviderOptionsWithTrace(projectCwd);
+    return {
+        provider,
+        model,
+        personaProviders,
+        providerOptions,
+        providerOptionsSource,
+        providerOptionsOriginResolver,
+    };
+}
+function resolvePreviewAllowedTools(step, resolution) {
+    const mergedProviderOptions = resolveEffectiveProviderOptions(resolution.providerOptionsSource, resolution.providerOptionsOriginResolver, resolution.providerOptions, step.providerOptions);
+    const resolvedProvider = resolveStepProviderModel({
+        step,
+        provider: resolution.provider,
+        model: resolution.model,
+        personaProviders: resolution.personaProviders,
+    }).provider;
+    assertProviderResolvedForCapabilitySensitiveOptions(resolvedProvider, {
+        stepName: step.name,
+        usesStructuredOutput: false,
+    });
+    return resolveAllowedToolsForProvider(mergedProviderOptions, step.outputContracts !== undefined && step.outputContracts.length > 0, step.edit, resolvedProvider) ?? [];
+}
+function buildStepPreviews(workflow, maxCount, projectCwd, resolution) {
+    if (maxCount <= 0 || workflow.steps.length === 0)
+        return [];
+    const stepMap = new Map(workflow.steps.map((step) => [step.name, step]));
+    const previews = [];
+    const visited = new Set();
+    let currentName = workflow.initialStep;
+    while (currentName && previews.length < maxCount) {
+        if (currentName === 'COMPLETE' || currentName === 'ABORT' || visited.has(currentName))
+            break;
+        visited.add(currentName);
+        const step = stepMap.get(currentName);
+        if (!step)
+            break;
+        previews.push({
+            name: step.name,
+            personaDisplayName: step.personaDisplayName,
+            personaContent: readStepPersona(step, projectCwd),
+            instructionContent: step.instruction,
+            allowedTools: resolvePreviewAllowedTools(step, resolution),
+            canEdit: step.edit === true,
+        });
+        currentName = step.rules?.[0]?.next;
+    }
+    return previews;
+}
+function buildFirstStepInfo(workflow, projectCwd, resolution) {
+    const step = workflow.steps.find((candidate) => candidate.name === workflow.initialStep);
+    if (!step)
+        return undefined;
+    return {
+        personaContent: readStepPersona(step, projectCwd),
+        personaDisplayName: step.personaDisplayName,
+        allowedTools: resolvePreviewAllowedTools(step, resolution),
+    };
+}
+export function getWorkflowDescription(identifier, projectCwd, previewCount, lookupCwd = projectCwd) {
+    const workflow = loadWorkflowByIdentifier(identifier, projectCwd, { lookupCwd });
+    if (!workflow) {
+        return { name: identifier, description: '', workflowStructure: '', stepPreviews: [] };
+    }
+    const resolution = resolvePreviewProviderResolution(projectCwd);
+    return {
+        name: workflow.name,
+        description: workflow.description ?? '',
+        workflowStructure: buildWorkflowString(workflow.steps),
+        stepPreviews: previewCount && previewCount > 0
+            ? buildStepPreviews(workflow, previewCount, projectCwd, resolution)
+            : [],
+        interactiveMode: workflow.interactiveMode,
+        firstStep: buildFirstStepInfo(workflow, projectCwd, resolution),
+    };
+}
+//# sourceMappingURL=workflowPreview.js.map

package/dist/infra/config/loaders/workflowPreview.js.map

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

package/dist/infra/config/loaders/workflowResolvedLoader.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowConfig } from '../../../core/models/index.js';
+import { type WorkflowTrustInfo, type WorkflowTrustSource } from './workflowTrustSource.js';
+type WorkflowLoadMode = 'runtime' | 'discovery';
+export interface WorkflowResolvedLoaderOptions {
+    callableArgs?: Record<string, string | string[]>;
+    loadMode?: WorkflowLoadMode;
+    lookupCwd: string;
+    parentTrustInfo?: WorkflowTrustInfo;
+    projectCwd: string;
+    source?: WorkflowTrustSource;
+}
+export declare function loadWorkflowFileWithResolutionOptions(filePath: string, options: WorkflowResolvedLoaderOptions): WorkflowConfig;
+export {};
+//# sourceMappingURL=workflowResolvedLoader.d.ts.map

package/dist/infra/config/loaders/workflowResolvedLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowResolvedLoader.d.ts","sourceRoot":"","sources":["../../../../src/infra/config/loaders/workflowResolvedLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAIpE,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAElC,KAAK,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAeD,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,6BAA6B,GACrC,cAAc,CAqBhB"}

package/dist/infra/config/loaders/workflowResolvedLoader.js

@@ -0,0 +1,32 @@
+import { loadWorkflowFromFile, loadWorkflowFromFileForDiscovery } from './workflowFileLoader.js';
+import { validateProjectWorkflowTrustBoundary } from './workflowTrustBoundary.js';
+import { resolveWorkflowTrustInfo, } from './workflowTrustSource.js';
+function buildWorkflowCallArgPolicy(parentTrustInfo, childTrustInfo) {
+    if (!parentTrustInfo || parentTrustInfo.isProjectTrustRoot || !childTrustInfo.isProjectTrustRoot) {
+        return undefined;
+    }
+    return {
+        allowExternalFacetRefs: false,
+    };
+}
+export function loadWorkflowFileWithResolutionOptions(filePath, options) {
+    const trustInfo = resolveWorkflowTrustInfo({
+        filePath,
+        projectCwd: options.projectCwd,
+        lookupCwd: options.lookupCwd,
+        source: options.source,
+    });
+    const loadWorkflow = options.loadMode === 'discovery'
+        ? loadWorkflowFromFileForDiscovery
+        : loadWorkflowFromFile;
+    const workflow = loadWorkflow(filePath, options.projectCwd, {
+        trustInfo,
+        callableArgs: options.callableArgs,
+        callableArgPolicy: buildWorkflowCallArgPolicy(options.parentTrustInfo, trustInfo),
+    });
+    if (trustInfo.source === 'project') {
+        validateProjectWorkflowTrustBoundary(workflow, filePath, options.projectCwd);
+    }
+    return workflow;
+}
+//# sourceMappingURL=workflowResolvedLoader.js.map

package/dist/infra/config/loaders/workflowResolvedLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowResolvedLoader.js","sourceRoot":"","sources":["../../../../src/infra/config/loaders/workflowResolvedLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EACL,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC;AAalC,SAAS,0BAA0B,CACjC,eAA8C,EAC9C,cAAiC;IAEjC,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,kBAAkB,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;QACjG,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,sBAAsB,EAAE,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,QAAgB,EAChB,OAAsC;IAEtC,MAAM,SAAS,GAAG,wBAAwB,CAAC;QACzC,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,WAAW;QACnD,CAAC,CAAC,gCAAgC;QAClC,CAAC,CAAC,oBAAoB,CAAC;IACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE;QAC1D,SAAS;QACT,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,iBAAiB,EAAE,0BAA0B,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC;KAClF,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACnC,oCAAoC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/infra/config/loaders/workflowResolver.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Workflow resolution.
+ */
+import type { WorkflowConfig } from '../../../core/models/index.js';
+import { type WorkflowTrustInfo } from './workflowTrustSource.js';
+import { type WorkflowDirEntry, type WorkflowDiscoveryConfig, type WorkflowDiscoveryWithSource, type WorkflowWithSource } from './workflowDiscovery.js';
+interface LoadWorkflowsOptions {
+    onWarning?: (message: string) => void;
+}
+export interface WorkflowLookupOptions {
+    basePath?: string;
+    lookupCwd?: string;
+}
+interface InternalWorkflowLookupOptions extends WorkflowLookupOptions {
+    callableArgs?: Record<string, string | string[]>;
+    parentTrustInfo?: WorkflowTrustInfo;
+    skipWorkflowCallContractValidation?: boolean;
+}
+export type { WorkflowDirEntry, WorkflowDiscoveryConfig, WorkflowDiscoveryWithSource, WorkflowSource, WorkflowWithSource, } from './workflowDiscovery.js';
+export { getWorkflowDescription, type FirstStepInfo, type StepPreview } from './workflowPreview.js';
+export declare function listBuiltinWorkflowNames(cwd: string, options?: {
+    includeDisabled?: boolean;
+}): string[];
+export declare function getBuiltinWorkflow(name: string, projectCwd: string): WorkflowConfig | null;
+export declare function loadWorkflow(name: string, projectCwd: string): WorkflowConfig | null;
+export declare function isWorkflowPath(identifier: string): boolean;
+export declare function validateWorkflowCallContracts(workflow: WorkflowConfig, projectCwd: string, lookupCwd?: string, options?: {
+    allowPathBasedCalls?: boolean;
+}): void;
+export declare function loadWorkflowByIdentifier(identifier: string, projectCwd: string, options?: WorkflowLookupOptions): WorkflowConfig | null;
+export declare function loadWorkflowByIdentifierForWorkflowCall(identifier: string, projectCwd: string, options: InternalWorkflowLookupOptions): WorkflowConfig | null;
+export declare function loadAllWorkflowsWithSources(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowWithSource<WorkflowConfig>>;
+export declare function loadAllWorkflowDiscoveryWithSources(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowDiscoveryWithSource>;
+export declare function loadAllStandaloneWorkflowsWithSources(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowDiscoveryWithSource>;
+export declare function listWorkflowEntries(cwd: string, options?: LoadWorkflowsOptions): WorkflowDirEntry[];
+export declare function listStandaloneWorkflowEntries(cwd: string, options?: LoadWorkflowsOptions): WorkflowDirEntry[];
+export declare function loadAllWorkflows(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowConfig>;
+export declare function loadAllWorkflowDiscovery(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowDiscoveryConfig>;
+export declare function loadAllStandaloneWorkflows(cwd: string, options?: LoadWorkflowsOptions): Map<string, WorkflowDiscoveryConfig>;
+export declare function listWorkflows(cwd: string, options?: LoadWorkflowsOptions): string[];
+//# sourceMappingURL=workflowResolver.d.ts.map

package/dist/infra/config/loaders/workflowResolver.d.ts.map

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

package/dist/infra/config/loaders/workflowResolver.js

@@ -0,0 +1,191 @@
+/**
+ * Workflow resolution.
+ */
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { isScopeRef, parseScopeRef } from 'faceted-prompting';
+import { validateWorkflowCallContracts as validateWorkflowCallContractsImpl } from './workflowCallContractValidator.js';
+import { buildWorkflowDiscoveryConfig, loadValidatedWorkflowDiscoveryEntry } from './workflowDiscoveryLoader.js';
+import { findWorkflowInLookupDirs, getBuiltinWorkflowPath, getNamedWorkflowLookupDirs, getWorkflowDirs, listBuiltinWorkflowNames as listBuiltinWorkflowNamesImpl, resolveWorkflowFile, } from './workflowLookupDirectories.js';
+import { loadWorkflowFileWithResolutionOptions } from './workflowResolvedLoader.js';
+import { getRepertoireDir } from '../paths.js';
+import { collectValidatedWorkflowEntries, iterateWorkflowDir, listRepertoireWorkflowEntries, loadAllWorkflowsWithSourcesFromDirs, } from './workflowDiscovery.js';
+export { getWorkflowDescription } from './workflowPreview.js';
+function resolvePath(pathInput, basePath) {
+    if (pathInput.startsWith('~')) {
+        return resolve(homedir(), pathInput.slice(1).replace(/^\//, ''));
+    }
+    if (isAbsolute(pathInput)) {
+        return pathInput;
+    }
+    return resolve(basePath, pathInput);
+}
+function loadWorkflowFromLookupDirs(name, lookupDirs, projectCwd, lookupCwd, callableArgs, parentTrustInfo) {
+    const match = findWorkflowInLookupDirs(name, lookupDirs);
+    if (!match) {
+        return null;
+    }
+    return loadWorkflowFileWithResolutionOptions(match.filePath, {
+        projectCwd,
+        lookupCwd,
+        source: match.source,
+        callableArgs,
+        parentTrustInfo,
+    });
+}
+export function listBuiltinWorkflowNames(cwd, options) {
+    return listBuiltinWorkflowNamesImpl(cwd, options);
+}
+export function getBuiltinWorkflow(name, projectCwd) {
+    const yamlPath = getBuiltinWorkflowPath(name, projectCwd);
+    if (!yamlPath) {
+        return null;
+    }
+    const workflow = existsSync(yamlPath)
+        ? loadWorkflowFromResolvedPath(yamlPath, projectCwd, projectCwd)
+        : null;
+    return finalizeLoadedWorkflow(workflow, projectCwd, projectCwd);
+}
+function loadWorkflowFromPath(filePath, basePath, projectCwd, lookupCwd, callableArgs, parentTrustInfo) {
+    const resolvedPath = resolvePath(filePath, basePath);
+    return loadWorkflowFromResolvedPath(resolvedPath, projectCwd, lookupCwd, callableArgs, parentTrustInfo);
+}
+function loadWorkflowFromResolvedPath(resolvedPath, projectCwd, lookupCwd = projectCwd, callableArgs, parentTrustInfo) {
+    if (!existsSync(resolvedPath)) {
+        return null;
+    }
+    return loadWorkflowFileWithResolutionOptions(resolvedPath, {
+        projectCwd,
+        lookupCwd,
+        callableArgs,
+        parentTrustInfo,
+    });
+}
+function finalizeLoadedWorkflow(workflow, projectCwd, lookupCwd, skipWorkflowCallContractValidation = false, allowPathBasedCalls = true) {
+    if (!workflow || skipWorkflowCallContractValidation) {
+        return workflow;
+    }
+    validateWorkflowCallContracts(workflow, projectCwd, lookupCwd, { allowPathBasedCalls });
+    return workflow;
+}
+function loadWorkflowForDiscovery(entry, cwd) {
+    return loadWorkflowFileWithResolutionOptions(entry.path, {
+        projectCwd: cwd,
+        lookupCwd: cwd,
+        source: entry.source,
+        loadMode: 'discovery',
+    });
+}
+function loadWorkflowForRuntime(entry, cwd) {
+    return loadWorkflowFileWithResolutionOptions(entry.path, {
+        projectCwd: cwd,
+        lookupCwd: cwd,
+        source: entry.source,
+    });
+}
+function validateLoadedWorkflowEntryContracts(workflow, cwd, allowPathBasedCalls) {
+    validateWorkflowCallContracts(workflow, cwd, cwd, { allowPathBasedCalls });
+}
+function loadValidatedWorkflowEntry(entry, cwd) {
+    return loadValidatedWorkflowDiscoveryEntry(entry, cwd, {
+        loadWorkflowForDiscovery,
+        validateWorkflowCallContracts: (workflow, projectCwd, options) => {
+            validateLoadedWorkflowEntryContracts(workflow, options?.lookupCwd ?? projectCwd, options?.allowPathBasedCalls ?? true);
+        },
+    });
+}
+function loadValidatedWorkflowConfigEntry(entry, cwd) {
+    const workflow = loadWorkflowForRuntime(entry, cwd);
+    validateLoadedWorkflowEntryContracts(workflow, cwd, true);
+    return workflow;
+}
+function loadValidatedStandaloneWorkflowEntry(entry, cwd) {
+    return buildWorkflowDiscoveryConfig(loadValidatedWorkflowConfigEntry(entry, cwd));
+}
+export function loadWorkflow(name, projectCwd) {
+    const workflow = loadWorkflowFromLookupDirs(name, getNamedWorkflowLookupDirs(projectCwd), projectCwd, projectCwd);
+    return finalizeLoadedWorkflow(workflow, projectCwd, projectCwd);
+}
+export function isWorkflowPath(identifier) {
+    return (identifier.startsWith('/') ||
+        identifier.startsWith('~') ||
+        identifier.startsWith('./') ||
+        identifier.startsWith('../') ||
+        identifier.endsWith('.yaml') ||
+        identifier.endsWith('.yml'));
+}
+function loadRepertoireWorkflowByRef(identifier, projectCwd, callableArgs, parentTrustInfo) {
+    const scopeRef = parseScopeRef(identifier);
+    const workflowsDir = join(getRepertoireDir(), `@${scopeRef.owner}`, scopeRef.repo, 'workflows');
+    const filePath = resolveWorkflowFile(workflowsDir, scopeRef.name);
+    return filePath
+        ? loadWorkflowFileWithResolutionOptions(filePath, {
+            projectCwd,
+            lookupCwd: projectCwd,
+            source: 'repertoire',
+            callableArgs,
+            parentTrustInfo,
+        })
+        : null;
+}
+export function validateWorkflowCallContracts(workflow, projectCwd, lookupCwd = projectCwd, options) {
+    validateWorkflowCallContractsImpl(workflow, projectCwd, {
+        isWorkflowPath,
+        loadWorkflowByIdentifierForWorkflowCall,
+    }, {
+        lookupCwd,
+        allowPathBasedCalls: options?.allowPathBasedCalls,
+    });
+}
+function loadWorkflowByIdentifierInternal(identifier, projectCwd, options) {
+    const lookupCwd = options?.lookupCwd ?? projectCwd;
+    const basePath = options?.basePath ?? lookupCwd;
+    const workflow = isScopeRef(identifier)
+        ? loadRepertoireWorkflowByRef(identifier, projectCwd, options?.callableArgs, options?.parentTrustInfo)
+        : isWorkflowPath(identifier)
+            ? loadWorkflowFromPath(identifier, basePath, projectCwd, lookupCwd, options?.callableArgs, options?.parentTrustInfo)
+            : loadWorkflowFromLookupDirs(identifier, getNamedWorkflowLookupDirs(projectCwd), projectCwd, lookupCwd, options?.callableArgs, options?.parentTrustInfo);
+    return finalizeLoadedWorkflow(workflow, projectCwd, lookupCwd, options?.skipWorkflowCallContractValidation === true);
+}
+export function loadWorkflowByIdentifier(identifier, projectCwd, options) {
+    return loadWorkflowByIdentifierInternal(identifier, projectCwd, options);
+}
+export function loadWorkflowByIdentifierForWorkflowCall(identifier, projectCwd, options) {
+    return loadWorkflowByIdentifierInternal(identifier, projectCwd, options);
+}
+export function loadAllWorkflowsWithSources(cwd, options) {
+    return loadAllWorkflowsWithSourcesFromDirs(cwd, getWorkflowDirs(cwd), options, loadValidatedWorkflowConfigEntry, true);
+}
+export function loadAllWorkflowDiscoveryWithSources(cwd, options) {
+    return loadAllWorkflowsWithSourcesFromDirs(cwd, getWorkflowDirs(cwd), options, loadValidatedWorkflowEntry);
+}
+export function loadAllStandaloneWorkflowsWithSources(cwd, options) {
+    return loadAllWorkflowsWithSourcesFromDirs(cwd, getWorkflowDirs(cwd), options, loadValidatedStandaloneWorkflowEntry);
+}
+export function listWorkflowEntries(cwd, options) {
+    const dirs = getWorkflowDirs(cwd);
+    const entries = dirs.flatMap(({ dir, source, disabled }) => Array.from(iterateWorkflowDir(dir, source, disabled)));
+    entries.push(...listRepertoireWorkflowEntries());
+    return collectValidatedWorkflowEntries(entries, cwd, options, loadValidatedWorkflowEntry).map(({ entry }) => entry);
+}
+export function listStandaloneWorkflowEntries(cwd, options) {
+    const dirs = getWorkflowDirs(cwd);
+    const entries = dirs.flatMap(({ dir, source, disabled }) => Array.from(iterateWorkflowDir(dir, source, disabled)));
+    entries.push(...listRepertoireWorkflowEntries());
+    return collectValidatedWorkflowEntries(entries, cwd, options, loadValidatedStandaloneWorkflowEntry)
+        .map(({ entry }) => entry);
+}
+export function loadAllWorkflows(cwd, options) {
+    return new Map(Array.from(loadAllWorkflowsWithSources(cwd, options).entries()).map(([name, entry]) => [name, entry.config]));
+}
+export function loadAllWorkflowDiscovery(cwd, options) {
+    return new Map(Array.from(loadAllWorkflowDiscoveryWithSources(cwd, options).entries()).map(([name, entry]) => [name, entry.config]));
+}
+export function loadAllStandaloneWorkflows(cwd, options) {
+    return new Map(Array.from(loadAllStandaloneWorkflowsWithSources(cwd, options).entries()).map(([name, entry]) => [name, entry.config]));
+}
+export function listWorkflows(cwd, options) {
+    return listWorkflowEntries(cwd, options).map((entry) => entry.name).sort();
+}
+//# sourceMappingURL=workflowResolver.js.map