import { PROMPT_CONTRACTS, guidedPromptArgumentsSchema, guidedPromptInventory, renderGuidedPrompt, type PromptContract, } from "../contracts/promptContracts.js"; import { AnalysisInputError } from "../domain/analysisErrorCore.js"; import { analysisInputErrorFromIssues, projectInputIssues, } from "../domain/inputIssueProjection.js"; import { err, ok, type Result } from "../domain/result.js"; import { guidedWorkflowsInputSchema, type GuidedWorkflowsResult, } from "../contracts/guidedWorkflowSchemas.js"; export const GUIDED_WORKFLOWS_OPERATION = "guided_workflows"; /** Validate and perform a provider-free list or render request. */ export const accessGuidedWorkflows = ( input: unknown, contracts: readonly PromptContract[] = PROMPT_CONTRACTS, ): Result => { const parsed = guidedWorkflowsInputSchema.safeParse(input); if (!parsed.success) return err( analysisInputErrorFromIssues( GUIDED_WORKFLOWS_OPERATION, parsed.error.issues, input, ), ); if (parsed.data.action === "list") return ok({ action: "list", workflows: guidedPromptInventory(contracts) }); const id = parsed.data.workflow_id; const contract = contracts.find(({ name }) => name === id); if (contract === undefined) return invalidInput( PROMPT_CONTRACTS.some(({ name }) => name === id) ? `Workflow '${id}' is not available in the selected tool-family scope. Use action=list to see the available identifiers.` : `Unknown workflow_id '${id}'. Use action=list to see the available identifiers.`, [{ path: ["workflow_id"], reason: "invalid_value" }], ); const arguments_ = parsed.data.arguments ?? {}; const validated = guidedPromptArgumentsSchema(contract).safeParse(arguments_); if (!validated.success) { const issues = projectInputIssues( validated.error.issues.map((issue) => ({ ...issue, path: ["arguments", ...issue.path], })), input, ); const missing = issues .filter(({ reason }) => reason === "missing_argument") .map(({ path }) => String(path.at(-1))); return invalidInput( missing.length === 0 ? "Correct the named guided workflow arguments and retry." : `Missing required arguments for ${id}: ${missing.join(", ")}.`, issues, ); } return ok({ action: "render", workflow_id: id, rendered_prompt: renderGuidedPrompt( contract, Object.fromEntries( Object.entries(validated.data).filter( (entry): entry is [string, string] => typeof entry[1] === "string", ), ), ), }); }; const invalidInput = ( userMessage: string, additionalIssues: ConstructorParameters[2], ): Result => err( new AnalysisInputError( GUIDED_WORKFLOWS_OPERATION, { userMessage }, additionalIssues, ), );