5ae77656e7
* feat(workflows): expose guided prompts through CLI and MCP * fix(workflows): address guided workflow review findings * fix(workflows): preserve scoped contracts and actionable validation * test(workflows): allow bounded CLI startup on shared hosts * test(workflows): audit guidance effects and content provenance * perf(workflows): defer rendering and separate catalog scope --------- Co-authored-by: Deepak-Kambala <[email protected]> Co-authored-by: gensokyo-dev <[email protected]>
95 lines
2.9 KiB
TypeScript
95 lines
2.9 KiB
TypeScript
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<GuidedWorkflowsResult, AnalysisInputError> => {
|
|
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<typeof AnalysisInputError>[2],
|
|
): Result<never, AnalysisInputError> =>
|
|
err(
|
|
new AnalysisInputError(
|
|
GUIDED_WORKFLOWS_OPERATION,
|
|
{ userMessage },
|
|
additionalIssues,
|
|
),
|
|
);
|