feat: add console draft authoring client
This commit is contained in:
@@ -0,0 +1,246 @@
|
||||
import { describe, expect, it, vi } from "vitest";
|
||||
import type { OperationName } from "../../connection/contracts.js";
|
||||
import {
|
||||
decodeDraftWorkspace,
|
||||
type AddCapabilityStepInput,
|
||||
type CreateEmptyDraftInput,
|
||||
type CreateFromCapabilityInput,
|
||||
type SetDraftRouteInput,
|
||||
type UpdateCapabilityStepInput,
|
||||
} from "./draft-workspace-models.js";
|
||||
import { createDraftAuthoringClient } from "./draft-authoring-client.js";
|
||||
import type { ConsoleWriteExecutor } from "./write-executor.js";
|
||||
|
||||
const canonicalWorkspace = {
|
||||
workspaceId: "draft-report",
|
||||
revision: 3,
|
||||
title: "Report",
|
||||
status: "valid" as const,
|
||||
diagnostics: [],
|
||||
summary: {
|
||||
name: "report",
|
||||
start: "read",
|
||||
stepCount: 1,
|
||||
routeCount: 0,
|
||||
steps: ["read"],
|
||||
},
|
||||
draft: { steps: [] },
|
||||
};
|
||||
|
||||
const createExecutor = () => {
|
||||
const run = vi.fn();
|
||||
const executor: ConsoleWriteExecutor = {
|
||||
run: <T>(
|
||||
operation: OperationName,
|
||||
params: unknown,
|
||||
decode: (value: unknown) => T,
|
||||
): Promise<T> => {
|
||||
run(operation, params, decode);
|
||||
return Promise.resolve(decode(canonicalWorkspace));
|
||||
},
|
||||
};
|
||||
return { executor, run };
|
||||
};
|
||||
|
||||
describe("DraftAuthoringClient", () => {
|
||||
it("lowers all six authoring operations and decodes canonical workspaces", async () => {
|
||||
const { executor: writeExecutor, run } = createExecutor();
|
||||
const client = createDraftAuthoringClient(writeExecutor);
|
||||
|
||||
const createEmptyInput = {
|
||||
workspaceId: " draft-empty ",
|
||||
name: " empty ",
|
||||
title: "Empty",
|
||||
inputSchema: { type: "object" },
|
||||
stateSchema: { type: "object" },
|
||||
outputSchema: { type: "object" },
|
||||
outcomes: ["done"],
|
||||
} satisfies CreateEmptyDraftInput;
|
||||
const createFromCapabilityInput = {
|
||||
workspaceId: " draft-report ",
|
||||
capabilityName: " demo.read ",
|
||||
name: " report ",
|
||||
title: "Report",
|
||||
inputSchema: { type: "object" },
|
||||
stateSchema: null,
|
||||
outputSchema: { type: "object" },
|
||||
input: [{ target: "text", value: "hello" }],
|
||||
output: null,
|
||||
inputMap: { text: "input.text" },
|
||||
outputMap: null,
|
||||
errorMessageSource: "error.message",
|
||||
} satisfies CreateFromCapabilityInput;
|
||||
const addCapabilityStepInput = {
|
||||
workspaceId: " draft-report ",
|
||||
revision: 3,
|
||||
stepId: " enrich ",
|
||||
capabilityName: " demo.enrich ",
|
||||
routeFromStep: " read ",
|
||||
routeFromOutcome: " success ",
|
||||
routes: { success: "enrich" },
|
||||
inputMap: { text: "input.text" },
|
||||
inputBindings: [{ target: "text", path: "input.text" }],
|
||||
bindOutputs: { result: "state.result" },
|
||||
description: "Enrich report",
|
||||
retry: 2,
|
||||
timeoutSeconds: 30,
|
||||
} satisfies AddCapabilityStepInput;
|
||||
const updateCapabilityStepInput = {
|
||||
workspaceId: " draft-report ",
|
||||
revision: 3,
|
||||
stepId: " enrich ",
|
||||
update: {
|
||||
description: "Updated",
|
||||
input: [{ target: "text", value: "updated" }],
|
||||
retry: null,
|
||||
timeoutSeconds: 45,
|
||||
},
|
||||
} satisfies UpdateCapabilityStepInput;
|
||||
const setRouteInput = {
|
||||
workspaceId: " draft-report ",
|
||||
revision: 3,
|
||||
stepId: " read ",
|
||||
outcome: " success ",
|
||||
target: " enrich ",
|
||||
} satisfies SetDraftRouteInput;
|
||||
|
||||
await expect(client.createEmpty(createEmptyInput)).resolves.toEqual(canonicalWorkspace);
|
||||
await expect(client.createFromCapability(createFromCapabilityInput)).resolves.toEqual(
|
||||
canonicalWorkspace,
|
||||
);
|
||||
await expect(client.addCapabilityStep(addCapabilityStepInput)).resolves.toEqual(
|
||||
canonicalWorkspace,
|
||||
);
|
||||
await expect(client.updateCapabilityStep(updateCapabilityStepInput)).resolves.toEqual(
|
||||
canonicalWorkspace,
|
||||
);
|
||||
await expect(client.setRoute(setRouteInput)).resolves.toEqual(canonicalWorkspace);
|
||||
await expect(client.validate(" draft-report ")).resolves.toEqual(canonicalWorkspace);
|
||||
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
1,
|
||||
"workflow.draft_workspaces.create_empty",
|
||||
{
|
||||
workspace_id: "draft-empty",
|
||||
name: "empty",
|
||||
title: "Empty",
|
||||
input_schema: { type: "object" },
|
||||
state_schema: { type: "object" },
|
||||
output_schema: { type: "object" },
|
||||
outcomes: ["done"],
|
||||
},
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
2,
|
||||
"workflow.draft_workspaces.create_from_capability",
|
||||
{
|
||||
workspace_id: "draft-report",
|
||||
capability_name: "demo.read",
|
||||
name: "report",
|
||||
title: "Report",
|
||||
input_schema: { type: "object" },
|
||||
state_schema: null,
|
||||
output_schema: { type: "object" },
|
||||
input: [{ target: "text", value: "hello" }],
|
||||
output: null,
|
||||
input_map: { text: "input.text" },
|
||||
output_map: null,
|
||||
error_message_source: "error.message",
|
||||
},
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
3,
|
||||
"workflow.draft_workspaces.add_step_from_capability",
|
||||
{
|
||||
workspace_id: "draft-report",
|
||||
revision: 3,
|
||||
step_id: "enrich",
|
||||
capability_name: "demo.enrich",
|
||||
route_from_step: "read",
|
||||
route_from_outcome: "success",
|
||||
routes: { success: "enrich" },
|
||||
input_map: { text: "input.text" },
|
||||
input_bindings: [{ target: "text", path: "input.text" }],
|
||||
bind_outputs: { result: "state.result" },
|
||||
desc: "Enrich report",
|
||||
retry: 2,
|
||||
timeout_seconds: 30,
|
||||
},
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
4,
|
||||
"workflow.draft_workspaces.update_capability_step",
|
||||
{
|
||||
workspace_id: "draft-report",
|
||||
revision: 3,
|
||||
step_id: "enrich",
|
||||
update: {
|
||||
desc: "Updated",
|
||||
input: [{ target: "text", value: "updated" }],
|
||||
retry: null,
|
||||
timeout_seconds: 45,
|
||||
},
|
||||
},
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
5,
|
||||
"workflow.draft_workspaces.set_route",
|
||||
{
|
||||
workspace_id: "draft-report",
|
||||
revision: 3,
|
||||
step_id: "read",
|
||||
outcome: "success",
|
||||
target: "enrich",
|
||||
},
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
expect(run).toHaveBeenNthCalledWith(
|
||||
6,
|
||||
"workflow.draft_workspaces.validate",
|
||||
{ workspace_id: "draft-report" },
|
||||
decodeDraftWorkspace,
|
||||
);
|
||||
});
|
||||
|
||||
it("rejects blank identifiers before invoking the executor", async () => {
|
||||
const { executor: writeExecutor, run } = createExecutor();
|
||||
const client = createDraftAuthoringClient(writeExecutor);
|
||||
|
||||
await expect(client.validate(" \t")).rejects.toMatchObject({
|
||||
kind: "operation",
|
||||
operation: "workflow.draft_workspaces.validate",
|
||||
});
|
||||
await expect(
|
||||
client.addCapabilityStep({
|
||||
workspaceId: "draft-report",
|
||||
revision: 1,
|
||||
stepId: " ",
|
||||
capabilityName: "demo.read",
|
||||
}),
|
||||
).rejects.toMatchObject({
|
||||
kind: "operation",
|
||||
operation: "workflow.draft_workspaces.add_step_from_capability",
|
||||
});
|
||||
expect(run).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it("rejects malformed canonical workspaces through the decoder", async () => {
|
||||
const writeExecutor: ConsoleWriteExecutor = {
|
||||
run: <T>(
|
||||
_operation: OperationName,
|
||||
_params: unknown,
|
||||
decode: (value: unknown) => T,
|
||||
): Promise<T> =>
|
||||
Promise.resolve(decode({ workspaceId: "draft-report" })),
|
||||
};
|
||||
const client = createDraftAuthoringClient(writeExecutor);
|
||||
|
||||
await expect(client.validate("draft-report")).rejects.toThrow(
|
||||
/DraftWorkspace is malformed/,
|
||||
);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user