@robota-sdk/agent-transport 3.0.0-beta.76 → 3.0.0-beta.78
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +661 -21
- package/README.md +8 -5
- package/dist/node/headless/index.cjs +1 -1
- package/dist/node/headless/index.d.ts +1 -1
- package/dist/node/headless/index.js +1 -1
- package/dist/node/{headless-mRYilLfC.js → headless-DG_MEbf0.js} +7 -4
- package/dist/node/headless-DG_MEbf0.js.map +1 -0
- package/dist/node/{headless-OnpVk4-k.cjs → headless-xq77JBq0.cjs} +6 -3
- package/dist/node/{index-E8Gx4-lc.d.ts → index-CrJ2Lhn3.d.ts} +16 -3
- package/dist/node/index-CrJ2Lhn3.d.ts.map +1 -0
- package/dist/node/index-JIvzrtaA.d.ts +52 -0
- package/dist/node/index-JIvzrtaA.d.ts.map +1 -0
- package/dist/node/{index-CYl7ksS6.d.ts → index-JTD_xtEQ.d.ts} +15 -2
- package/dist/node/index-JTD_xtEQ.d.ts.map +1 -0
- package/dist/node/index-y_HBOfzO.d.ts +52 -0
- package/dist/node/index-y_HBOfzO.d.ts.map +1 -0
- package/dist/node/index.cjs +1 -1
- package/dist/node/index.d.ts +10 -4
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +1 -1
- package/dist/node/index.js.map +1 -1
- package/dist/node/programmatic/index.cjs +1 -0
- package/dist/node/programmatic/index.d.ts +2 -0
- package/dist/node/programmatic/index.js +1 -0
- package/dist/node/programmatic-6wLf68qJ.cjs +1 -0
- package/dist/node/programmatic-70dxIXtS.js +2 -0
- package/dist/node/programmatic-70dxIXtS.js.map +1 -0
- package/dist/node/testing/index.cjs +1 -1
- package/dist/node/testing/index.d.ts +2 -21
- package/dist/node/testing/index.js +1 -2
- package/package.json +18 -6
- package/src/__tests__/programmatic/programmatic-ask-user.test.ts +32 -0
- package/src/__tests__/programmatic/programmatic-driver.test.ts +107 -0
- package/src/__tests__/programmatic/programmatic-flows.test.ts +140 -0
- package/src/__tests__/transport-registry.stop-all.test.ts +53 -0
- package/src/headless/HeadlessInteractionChannel.ts +22 -5
- package/src/headless/__tests__/headless-goal-runner.test.ts +108 -0
- package/src/headless/__tests__/headless-runner.test.ts +2 -1
- package/src/headless/headless-runner.ts +67 -1
- package/src/headless/headless-stream-json.ts +1 -1
- package/src/headless/print-terminal.ts +1 -0
- package/src/index.ts +1 -0
- package/src/programmatic/ProgrammaticInteractionChannel.ts +82 -0
- package/src/programmatic/createProgrammaticAgent.ts +71 -0
- package/src/programmatic/index.ts +5 -0
- package/src/testing/index.ts +7 -4
- package/src/transport-registry.ts +15 -3
- package/dist/node/headless-mRYilLfC.js.map +0 -1
- package/dist/node/index-CYl7ksS6.d.ts.map +0 -1
- package/dist/node/index-E8Gx4-lc.d.ts.map +0 -1
- package/dist/node/testing/index.d.ts.map +0 -1
- package/dist/node/testing/index.js.map +0 -1
- package/src/testing/__tests__/scripted-provider.test.ts +0 -73
- package/src/testing/scripted-provider.ts +0 -73
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
2
|
|
|
3
|
-
import type { TBackgroundTaskEvent } from '@robota-sdk/agent-framework';
|
|
4
3
|
import type {
|
|
5
4
|
ICommandResult,
|
|
6
5
|
IExecutionResult,
|
|
7
6
|
IInteractiveSession,
|
|
8
7
|
TBackgroundJobGroupEvent,
|
|
9
8
|
} from '@robota-sdk/agent-interface-transport';
|
|
9
|
+
import type { TBackgroundTaskEvent } from '@robota-sdk/agent-interface-transport';
|
|
10
10
|
|
|
11
11
|
type TSlashCommandExecution =
|
|
12
12
|
| { readonly kind: 'not-slash' }
|
package/src/index.ts
CHANGED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ProgrammaticInteractionChannel — an in-process IInteractionChannel adapter (INFRA-019).
|
|
3
|
+
*
|
|
4
|
+
* The "programmatic preset" adapter slot reserved by the interaction contract: instead of an Ink TUI
|
|
5
|
+
* or a print runner, this channel lets a caller push a message in-process and read back the structured
|
|
6
|
+
* `InteractionEvent` stream the framework already emits. It uses the documented one-way `write()`
|
|
7
|
+
* protocol consumed by `createInteractiveRuntime` (not the TUI's direct-wiring path).
|
|
8
|
+
*
|
|
9
|
+
* Production transport adapter — lives in transport core. Tests and automation consume it; it never
|
|
10
|
+
* depends on test code.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
import type { IActionRequest, TActionResponse } from '@robota-sdk/agent-core';
|
|
14
|
+
import type {
|
|
15
|
+
IInteractionChannel,
|
|
16
|
+
ICommandInfo,
|
|
17
|
+
InteractionEvent,
|
|
18
|
+
} from '@robota-sdk/agent-interface-transport';
|
|
19
|
+
|
|
20
|
+
export class ProgrammaticInteractionChannel implements IInteractionChannel {
|
|
21
|
+
/** Full structured event stream pushed by the framework, in order. */
|
|
22
|
+
readonly events: InteractionEvent[] = [];
|
|
23
|
+
|
|
24
|
+
availableCommands: ICommandInfo[] = [];
|
|
25
|
+
busy = false;
|
|
26
|
+
started = false;
|
|
27
|
+
stopped = false;
|
|
28
|
+
|
|
29
|
+
private submitHandler: ((text: string) => Promise<void>) | null = null;
|
|
30
|
+
private readonly userActionResponses: TActionResponse[] = [];
|
|
31
|
+
|
|
32
|
+
// ── IInteractionChannel ──────────────────────────────────────
|
|
33
|
+
|
|
34
|
+
onSubmit(handler: (text: string) => Promise<void>): void {
|
|
35
|
+
this.submitHandler = handler;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
write(event: InteractionEvent): void {
|
|
39
|
+
this.events.push(event);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* CMD-004 unified ask. Resolves from the pre-supplied queue (FIFO); an empty queue resolves
|
|
44
|
+
* `{ type: 'cancelled' }` so a programmatic run never blocks on an un-answered question.
|
|
45
|
+
*/
|
|
46
|
+
async askUser(_request: IActionRequest): Promise<TActionResponse> {
|
|
47
|
+
return this.userActionResponses.shift() ?? { type: 'cancelled' };
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
setAvailableCommands(commands: ICommandInfo[]): void {
|
|
51
|
+
this.availableCommands = commands;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
setBusy(busy: boolean): void {
|
|
55
|
+
this.busy = busy;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
async start(): Promise<void> {
|
|
59
|
+
this.started = true;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
async stop(): Promise<void> {
|
|
63
|
+
this.stopped = true;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// ── Programmatic driving surface ─────────────────────────────
|
|
67
|
+
|
|
68
|
+
/** Push a user submission into the framework (the programmatic "user types and presses enter"). */
|
|
69
|
+
async submit(text: string): Promise<void> {
|
|
70
|
+
if (!this.submitHandler) {
|
|
71
|
+
throw new Error(
|
|
72
|
+
'ProgrammaticInteractionChannel: no submit handler registered — start the runtime first',
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
await this.submitHandler(text);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** Pre-answer the next `askUser` (CMD-004 unified ask). */
|
|
79
|
+
queueUserAction(response: TActionResponse): void {
|
|
80
|
+
this.userActionResponses.push(response);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* createProgrammaticAgent — the in-process implementation of the client-side agent contract
|
|
3
|
+
* (`IAgentDriver`, INFRA-020; introduced as the programmatic driver in INFRA-019).
|
|
4
|
+
*
|
|
5
|
+
* Wraps `createInteractiveRuntime` with a {@link ProgrammaticInteractionChannel} so a caller can drive
|
|
6
|
+
* the real agent structurally: `start()`, `send(text)` (awaits the whole turn), then read assistant
|
|
7
|
+
* replies / tool calls / errors as data — no terminal, no PTY, no scraping. The observation accessors
|
|
8
|
+
* delegate to the shared `read*` helpers in `@robota-sdk/agent-interface-transport`, so the
|
|
9
|
+
* filter/derivation logic is not re-implemented here.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { createInteractiveRuntime } from '@robota-sdk/agent-framework';
|
|
13
|
+
import {
|
|
14
|
+
readAssistantReplies,
|
|
15
|
+
readErrors,
|
|
16
|
+
readLastAssistantText,
|
|
17
|
+
readToolCalls,
|
|
18
|
+
} from '@robota-sdk/agent-interface-transport';
|
|
19
|
+
|
|
20
|
+
import { ProgrammaticInteractionChannel } from './ProgrammaticInteractionChannel.js';
|
|
21
|
+
|
|
22
|
+
import type { IAIProvider, TActionResponse, TPermissionMode } from '@robota-sdk/agent-core';
|
|
23
|
+
import type { ICommandModule, IInteractiveRuntime } from '@robota-sdk/agent-framework';
|
|
24
|
+
import type { IAgentDriver, IInteractiveSessionStore } from '@robota-sdk/agent-interface-transport';
|
|
25
|
+
|
|
26
|
+
export interface ICreateProgrammaticAgentOptions {
|
|
27
|
+
/** Provider that answers the agent loop (e.g. a real provider, or the scripted provider in tests). */
|
|
28
|
+
provider: IAIProvider;
|
|
29
|
+
/** Working directory for session creation. */
|
|
30
|
+
cwd: string;
|
|
31
|
+
/** Slash-command modules to register (defaults to none). */
|
|
32
|
+
commandModules?: readonly ICommandModule[];
|
|
33
|
+
/** Optional session store for persistence. */
|
|
34
|
+
sessionStore?: IInteractiveSessionStore;
|
|
35
|
+
/** Permission mode for tool execution (e.g. `'bypassPermissions'` for unattended driving). */
|
|
36
|
+
permissionMode?: TPermissionMode;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Construct an in-process {@link IAgentDriver} bound to a real `InteractiveSession`. The returned
|
|
41
|
+
* driver's accessors are the shared `read*` helpers applied to the captured event stream.
|
|
42
|
+
*/
|
|
43
|
+
export function createProgrammaticAgent(options: ICreateProgrammaticAgentOptions): IAgentDriver {
|
|
44
|
+
const channel = new ProgrammaticInteractionChannel();
|
|
45
|
+
const runtime: IInteractiveRuntime = createInteractiveRuntime({
|
|
46
|
+
channel,
|
|
47
|
+
commandModules: options.commandModules ?? [],
|
|
48
|
+
provider: options.provider,
|
|
49
|
+
cwd: options.cwd,
|
|
50
|
+
sessionStore: options.sessionStore,
|
|
51
|
+
permissionMode: options.permissionMode,
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
let started = false;
|
|
55
|
+
|
|
56
|
+
return {
|
|
57
|
+
events: channel.events,
|
|
58
|
+
start: async (): Promise<void> => {
|
|
59
|
+
if (started) return;
|
|
60
|
+
started = true;
|
|
61
|
+
await runtime.start();
|
|
62
|
+
},
|
|
63
|
+
send: (text: string): Promise<void> => channel.submit(text),
|
|
64
|
+
queueUserAction: (response: TActionResponse): void => channel.queueUserAction(response),
|
|
65
|
+
assistantReplies: (): string[] => readAssistantReplies(channel.events),
|
|
66
|
+
lastAssistantText: (): string | undefined => readLastAssistantText(channel.events),
|
|
67
|
+
toolCalls: () => readToolCalls(channel.events),
|
|
68
|
+
errors: (): Error[] => readErrors(channel.events),
|
|
69
|
+
stop: (): Promise<void> => runtime.stop(),
|
|
70
|
+
};
|
|
71
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { ProgrammaticInteractionChannel } from './ProgrammaticInteractionChannel.js';
|
|
2
|
+
export { createProgrammaticAgent } from './createProgrammaticAgent.js';
|
|
3
|
+
export type { ICreateProgrammaticAgentOptions } from './createProgrammaticAgent.js';
|
|
4
|
+
// The driver's return type is the shared client contract `IAgentDriver`; import it from its SSOT
|
|
5
|
+
// `@robota-sdk/agent-interface-transport` (not re-exported here, to avoid a pass-through layer).
|
package/src/testing/index.ts
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Test-only fixtures
|
|
3
|
-
*
|
|
2
|
+
* Test-only fixtures. Exported via the `./testing` subpath; never import from runtime code.
|
|
3
|
+
*
|
|
4
|
+
* The deterministic scripted provider SSOT now lives in `@robota-sdk/agent-core/testing`
|
|
5
|
+
* (TEST-003) so framework-level functional tests can reach it without a reverse dependency on
|
|
6
|
+
* `agent-transport`. This subpath re-exports it for existing transport/CLI E2E consumers.
|
|
4
7
|
*/
|
|
5
8
|
|
|
6
|
-
export { createScriptedProvider } from '
|
|
7
|
-
export type { IScriptedProvider, TScriptedTurn } from '
|
|
9
|
+
export { createScriptedProvider } from '@robota-sdk/agent-core/testing';
|
|
10
|
+
export type { IScriptedProvider, TScriptedTurn } from '@robota-sdk/agent-core/testing';
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
import { readSettings, writeSettings, type TSettingsData } from '@robota-sdk/agent-framework';
|
|
9
9
|
|
|
10
|
-
import type { TUniversalValue } from '@robota-sdk/agent-core';
|
|
10
|
+
import type { IDestroyResult, TUniversalValue } from '@robota-sdk/agent-core';
|
|
11
11
|
import type {
|
|
12
12
|
IConfigurableTransport,
|
|
13
13
|
IInteractiveSession,
|
|
@@ -67,10 +67,22 @@ export class TransportRegistry {
|
|
|
67
67
|
}
|
|
68
68
|
}
|
|
69
69
|
|
|
70
|
-
|
|
70
|
+
/**
|
|
71
|
+
* Stop every registered transport — **best-effort** (CORE-013 disposal convention): one
|
|
72
|
+
* transport's stop failure must not skip the others or reject a fire-and-forget caller.
|
|
73
|
+
* Failures are collected into the returned result.
|
|
74
|
+
*/
|
|
75
|
+
async stopAll(): Promise<IDestroyResult> {
|
|
76
|
+
const errors: Error[] = [];
|
|
71
77
|
for (const transport of this.entries.values()) {
|
|
72
|
-
|
|
78
|
+
try {
|
|
79
|
+
await transport.stop();
|
|
80
|
+
} catch (error) {
|
|
81
|
+
// allow-fallback: best-effort disposal IS the contract — the failure is collected into the returned result and the remaining transports still stop (CORE-013 convention)
|
|
82
|
+
errors.push(error instanceof Error ? error : new Error(String(error)));
|
|
83
|
+
}
|
|
73
84
|
}
|
|
85
|
+
return { errors };
|
|
74
86
|
}
|
|
75
87
|
|
|
76
88
|
private resolveConfig(
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"headless-mRYilLfC.js","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-stream-json.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"sourcesContent":["/**\n * ITerminalOutput implementation for print mode (-p).\n *\n * Writes to stdout/stderr directly. The readline-based prompt and select are\n * only invoked if the agent triggers a permission-gated tool, which is rare in\n * one-shot print mode but must still work correctly.\n */\n\nimport * as readline from 'node:readline';\nimport type { ITerminalOutput, ISpinner } from '@robota-sdk/agent-core';\n\nexport class PrintTerminal implements ITerminalOutput {\n write(text: string): void {\n process.stdout.write(text);\n }\n writeLine(text: string): void {\n process.stdout.write(text + '\\n');\n }\n writeMarkdown(md: string): void {\n process.stdout.write(md);\n }\n writeError(text: string): void {\n process.stderr.write(text + '\\n');\n }\n prompt(question: string): Promise<string> {\n return new Promise<string>((resolve) => {\n const rl = readline.createInterface({\n input: process.stdin,\n output: process.stdout,\n terminal: false,\n historySize: 0,\n });\n rl.question(question, (answer) => {\n rl.close();\n resolve(answer);\n });\n });\n }\n async select(options: string[], initialIndex = 0): Promise<number> {\n for (let i = 0; i < options.length; i++) {\n const marker = i === initialIndex ? '>' : ' ';\n process.stdout.write(` ${marker} ${i + 1}) ${options[i]}\\n`);\n }\n const answer = await this.prompt(\n ` Choose [1-${options.length}] (default: ${options[initialIndex]}): `,\n );\n const trimmed = answer.trim().toLowerCase();\n if (trimmed === '') return initialIndex;\n const num = parseInt(trimmed, 10);\n if (!isNaN(num) && num >= 1 && num <= options.length) return num - 1;\n return initialIndex;\n }\n spinner(_message: string): ISpinner {\n return { stop(): void {}, update(): void {} };\n }\n}\n","const PRINTABLE_ASCII_START = 32;\n\nexport const promptInput = (label: string, masked = false): Promise<string> =>\n new Promise<string>((resolve, reject) => {\n process.stdout.write(label);\n let input = '';\n const stdin = process.stdin;\n const wasRaw = stdin.isRaw;\n if (!stdin.isTTY) {\n reject(\n new Error(\n 'Cannot prompt for input: stdin is not a TTY.\\n' +\n 'Set your API key via environment variable instead:\\n' +\n ' ANTHROPIC_API_KEY=<key> robota\\n' +\n ' OPENAI_API_KEY=<key> robota',\n ),\n );\n return;\n }\n stdin.setRawMode(true);\n stdin.resume();\n stdin.setEncoding('utf8');\n const onData = (data: string): void => {\n for (const ch of data) {\n if (ch === '\\r' || ch === '\\n') {\n stdin.removeListener('data', onData);\n stdin.setRawMode(wasRaw ?? false);\n stdin.pause();\n process.stdout.write('\\n');\n resolve(input.trim());\n return;\n } else if (ch === '\\x7f' || ch === '\\b') {\n if (input.length > 0) {\n input = input.slice(0, -1);\n process.stdout.write('\\b \\b');\n }\n } else if (ch === '\\x03') {\n stdin.removeListener('data', onData);\n stdin.setRawMode(wasRaw ?? false);\n stdin.pause();\n process.stdout.write('\\n');\n process.exit(0);\n } else if (ch.charCodeAt(0) >= PRINTABLE_ASCII_START) {\n input += ch;\n process.stdout.write(masked ? '*' : ch);\n }\n }\n };\n stdin.on('data', onData);\n });\n","import { randomUUID } from 'node:crypto';\n\nimport type { TBackgroundTaskEvent } from '@robota-sdk/agent-framework';\nimport type {\n ICommandResult,\n IExecutionResult,\n IInteractiveSession,\n TBackgroundJobGroupEvent,\n} from '@robota-sdk/agent-interface-transport';\n\ntype TSlashCommandExecution =\n | { readonly kind: 'not-slash' }\n | { readonly kind: 'command-result'; readonly result: ICommandResult }\n | { readonly kind: 'session-execution' };\n\nfunction parseSlashCommand(prompt: string): { name: string; args: string } | null {\n const trimmed = prompt.trimStart();\n if (!trimmed.startsWith('/')) return null;\n const withoutSlash = trimmed.slice(1);\n const [name = '', ...args] = withoutSlash.split(/\\s+/);\n if (name.length === 0) return null;\n return { name, args: args.join(' ') };\n}\n\nexport async function executeSlashCommandIfPresent(\n session: IInteractiveSession,\n prompt: string,\n): Promise<TSlashCommandExecution> {\n const command = parseSlashCommand(prompt);\n if (!command) return { kind: 'not-slash' };\n\n const result = await session.executeCommand(command.name, command.args);\n if (result) {\n if (result.effects?.some((effect) => effect.type === 'session-execution-started')) {\n return { kind: 'session-execution' };\n }\n return { kind: 'command-result', result };\n }\n return {\n kind: 'command-result',\n result: { message: `Unknown command \"/${command.name}\".`, success: false },\n };\n}\n\ntype TStreamJsonEvent =\n | {\n type: 'content_block_delta';\n delta: { type: 'text_delta'; text: string };\n }\n | {\n type: 'background_task_event';\n background_task_event: TBackgroundTaskEvent;\n }\n | {\n type: 'background_job_group_event';\n background_job_group_event: TBackgroundJobGroupEvent;\n };\n\ninterface IStreamJsonHandlers {\n onTextDelta: (text: string) => void;\n onBackgroundTaskEvent: (event: TBackgroundTaskEvent) => void;\n onBackgroundJobGroupEvent: (event: TBackgroundJobGroupEvent) => void;\n onComplete: (result: IExecutionResult) => void;\n onInterrupted: (result: IExecutionResult) => void;\n onError: (error: Error) => void;\n}\n\nfunction writeStreamJsonEvent(\n session: IInteractiveSession,\n getSessionId: (s: IInteractiveSession) => string,\n event: TStreamJsonEvent,\n): void {\n const output = JSON.stringify({\n type: 'stream_event',\n event,\n session_id: getSessionId(session),\n uuid: randomUUID(),\n });\n process.stdout.write(output + '\\n');\n}\n\nexport function subscribeStreamJsonEvents(\n session: IInteractiveSession,\n getSessionId: (s: IInteractiveSession) => string,\n writeJsonResult: (\n sessionId: string,\n result: string,\n subtype: 'success' | 'error',\n error?: Error,\n ) => void,\n resolve: (exitCode: number) => void,\n): () => void {\n const emit = (event: TStreamJsonEvent): void =>\n writeStreamJsonEvent(session, getSessionId, event);\n\n const onTextDelta = (text: string): void =>\n emit({ type: 'content_block_delta', delta: { type: 'text_delta', text } });\n const onBackgroundTaskEvent = (event: TBackgroundTaskEvent): void =>\n emit({ type: 'background_task_event', background_task_event: event });\n const onBackgroundJobGroupEvent = (event: TBackgroundJobGroupEvent): void =>\n emit({ type: 'background_job_group_event', background_job_group_event: event });\n\n const cleanup = (): void =>\n unsubscribeStreamJsonEvents(session, {\n onTextDelta,\n onBackgroundTaskEvent,\n onBackgroundJobGroupEvent,\n onComplete,\n onInterrupted,\n onError,\n });\n\n const onComplete = (result: IExecutionResult): void => {\n cleanup();\n writeJsonResult(getSessionId(session), result.response, 'success');\n resolve(0);\n };\n const onInterrupted = (result: IExecutionResult): void => {\n cleanup();\n writeJsonResult(getSessionId(session), result.response, 'success');\n resolve(0);\n };\n const onError = (error: Error): void => {\n cleanup();\n writeJsonResult(getSessionId(session), '', 'error', error);\n resolve(1);\n };\n\n session.on('text_delta', onTextDelta);\n session.on('background_task_event', onBackgroundTaskEvent);\n session.on('background_job_group_event', onBackgroundJobGroupEvent);\n session.on('complete', onComplete);\n session.on('interrupted', onInterrupted);\n session.on('error', onError);\n return cleanup;\n}\n\nfunction unsubscribeStreamJsonEvents(\n session: IInteractiveSession,\n handlers: IStreamJsonHandlers,\n): void {\n session.off('text_delta', handlers.onTextDelta);\n session.off('background_task_event', handlers.onBackgroundTaskEvent);\n session.off('background_job_group_event', handlers.onBackgroundJobGroupEvent);\n session.off('complete', handlers.onComplete);\n session.off('interrupted', handlers.onInterrupted);\n session.off('error', handlers.onError);\n}\n","import { executeSlashCommandIfPresent, subscribeStreamJsonEvents } from './headless-stream-json.js';\n\nimport type { IExecutionResult, IInteractiveSession } from '@robota-sdk/agent-interface-transport';\n\nexport type TOutputFormat = 'text' | 'json' | 'stream-json';\n\nexport interface IHeadlessRunnerOptions {\n session: IInteractiveSession;\n outputFormat: TOutputFormat;\n}\n\nexport function createHeadlessRunner(options: IHeadlessRunnerOptions): {\n run: (prompt: string) => Promise<number>;\n} {\n const { session, outputFormat } = options;\n return {\n run: (prompt: string): Promise<number> => {\n if (outputFormat === 'text') return runTextFormat(session, prompt);\n if (outputFormat === 'json') return runJsonFormat(session, prompt);\n return runStreamJsonFormat(session, prompt);\n },\n };\n}\n\nexport function resolveErrorCode(error: Error): string {\n const msg = error.message.toLowerCase();\n if (msg.includes('api key') || msg.includes('no provider') || msg.includes('provider')) {\n return 'config_error';\n }\n if (msg.includes('tool') || msg.includes('execution')) {\n return 'tool_error';\n }\n return 'api_error';\n}\n\nexport function writeJsonResult(\n sessionId: string,\n result: string,\n subtype: 'success' | 'error',\n error?: Error,\n): void {\n const payload: Record<string, unknown> = {\n type: 'result',\n result,\n session_id: sessionId,\n subtype,\n };\n if (subtype === 'error' && error !== undefined) {\n payload['error_code'] = resolveErrorCode(error);\n }\n const output = JSON.stringify(payload);\n process.stdout.write(output + '\\n');\n}\n\nexport function getSessionId(session: IInteractiveSession): string {\n try {\n return session.getSession().getSessionId();\n } catch {\n // allow-fallback: session may not be initialized yet\n return '';\n }\n}\n\nfunction runTextFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n return new Promise<number>((resolve) => {\n const cleanup = (): void => {\n session.off('complete', onComplete);\n session.off('interrupted', onInterrupted);\n session.off('error', onError);\n };\n const onComplete = (result: IExecutionResult): void => {\n cleanup();\n process.stdout.write(result.response + '\\n');\n resolve(0);\n };\n const onInterrupted = (result: IExecutionResult): void => {\n cleanup();\n if (result.response) process.stdout.write(result.response + '\\n');\n resolve(0);\n };\n const onError = (error: Error): void => {\n cleanup();\n process.stderr.write(error.message + '\\n');\n resolve(1);\n };\n\n session.on('complete', onComplete);\n session.on('interrupted', onInterrupted);\n session.on('error', onError);\n\n void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n if (cmd.kind === 'command-result') {\n cleanup();\n process.stdout.write(cmd.result.message + '\\n');\n resolve(cmd.result.success ? 0 : 1);\n return;\n }\n if (cmd.kind !== 'session-execution') void session.submit(prompt);\n });\n });\n}\n\nfunction runJsonFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n return new Promise<number>((resolve) => {\n const cleanup = (): void => {\n session.off('complete', onComplete);\n session.off('interrupted', onInterrupted);\n session.off('error', onError);\n };\n const onComplete = (result: IExecutionResult): void => {\n cleanup();\n writeJsonResult(getSessionId(session), result.response, 'success');\n resolve(0);\n };\n const onInterrupted = (result: IExecutionResult): void => {\n cleanup();\n writeJsonResult(getSessionId(session), result.response, 'success');\n resolve(0);\n };\n const onError = (error: Error): void => {\n cleanup();\n writeJsonResult(getSessionId(session), '', 'error', error);\n resolve(1);\n };\n\n session.on('complete', onComplete);\n session.on('interrupted', onInterrupted);\n session.on('error', onError);\n\n void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n if (cmd.kind === 'command-result') {\n cleanup();\n writeJsonResult(\n getSessionId(session),\n cmd.result.message,\n cmd.result.success ? 'success' : 'error',\n );\n resolve(cmd.result.success ? 0 : 1);\n return;\n }\n if (cmd.kind !== 'session-execution') void session.submit(prompt);\n });\n });\n}\n\nfunction runStreamJsonFormat(session: IInteractiveSession, prompt: string): Promise<number> {\n return new Promise<number>((resolve) => {\n const cleanup = subscribeStreamJsonEvents(session, getSessionId, writeJsonResult, resolve);\n\n void executeSlashCommandIfPresent(session, prompt).then((cmd) => {\n if (cmd.kind === 'command-result') {\n cleanup();\n writeJsonResult(\n getSessionId(session),\n cmd.result.message,\n cmd.result.success ? 'success' : 'error',\n );\n resolve(cmd.result.success ? 0 : 1);\n return;\n }\n if (cmd.kind !== 'session-execution') void session.submit(prompt);\n });\n });\n}\n","/**\n * ITransportAdapter implementation for headless transport.\n *\n * Wraps createHeadlessRunner into the unified ITransportAdapter interface.\n * After start() completes, getExitCode() returns the runner's exit code.\n */\n\nimport { createHeadlessRunner } from './headless-runner.js';\n\nimport type { TOutputFormat } from './headless-runner.js';\nimport type { IInteractiveSession, ITransportAdapter } from '@robota-sdk/agent-interface-transport';\n\nexport interface IHeadlessTransportOptions {\n /** Output format: 'text', 'json', or 'stream-json'. */\n outputFormat: TOutputFormat;\n /** The prompt to execute. */\n prompt: string;\n}\n\nexport function createHeadlessTransport(\n options: IHeadlessTransportOptions,\n): ITransportAdapter<IInteractiveSession> & { getExitCode(): number } {\n let session: IInteractiveSession | null = null;\n let exitCode = 0;\n\n return {\n name: 'headless',\n attach(s: IInteractiveSession) {\n session = s;\n },\n async start() {\n if (!session) throw new Error('No session attached. Call attach() first.');\n const runner = createHeadlessRunner({ session, outputFormat: options.outputFormat });\n exitCode = await runner.run(options.prompt);\n },\n async stop() {\n /* no-op: headless runner completes in start() */\n },\n getExitCode() {\n return exitCode;\n },\n };\n}\n","/**\n * HeadlessInteractionChannel — owns session lifecycle for non-interactive (print) mode.\n *\n * Mirrors TuiInteractionChannel's ownership pattern: session creation lives here,\n * not in the caller. print-mode.ts constructs this and calls run().\n */\n\nimport { execSync } from 'node:child_process';\n\nimport { InteractiveSession } from '@robota-sdk/agent-framework';\n\nimport { createHeadlessRunner, type TOutputFormat } from './headless-runner.js';\n\nimport type { IAIProvider, TPermissionMode } from '@robota-sdk/agent-core';\nimport type {\n IBackgroundTaskRunner,\n ICommandHostAdapters,\n ICommandModule,\n TSubagentRunnerFactory,\n TShellExecFn,\n} from '@robota-sdk/agent-framework';\nimport type { IInteractiveSessionStore } from '@robota-sdk/agent-interface-transport';\n\nexport interface IHeadlessInteractionChannelOptions {\n cwd: string;\n provider: IAIProvider;\n outputFormat: TOutputFormat;\n permissionMode?: TPermissionMode;\n maxTurns?: number;\n sessionStore?: IInteractiveSessionStore;\n /** Continue/resume an existing session by id (print-mode parity with TUI). */\n resumeSessionId?: string;\n /** Fork the resumed session into a new independent session instead of appending. */\n forkSession?: boolean;\n sessionName?: string;\n bare?: boolean;\n allowedTools?: string[];\n deniedTools?: string[];\n appendSystemPrompt?: string;\n systemPrompt?: string;\n /** Name reported to the underlying agent config (resolved by the CLI, e.g. preset agentName). */\n agentName?: string;\n /** Active preset id selected at startup (PRESET-011 runtime state). Defaults to 'default'. */\n activePresetId?: string;\n /** Preset persona block composed as a `source: 'persona'` system-prompt section (priority 5). */\n persona?: string;\n /** Preset execution capability: activate agent runtime + subagent/background dispatch. */\n enableParallelSubagents?: boolean;\n /** Preset execution capability: run a post-task self-verification step. */\n selfVerification?: boolean;\n backgroundTaskRunners?: IBackgroundTaskRunner[];\n subagentRunnerFactory?: TSubagentRunnerFactory;\n commandModules?: readonly ICommandModule[];\n commandHostAdapters?: ICommandHostAdapters;\n shellExec?: TShellExecFn;\n}\n\nexport class HeadlessInteractionChannel {\n private readonly opts: IHeadlessInteractionChannelOptions;\n private exitCode = 0;\n\n constructor(options: IHeadlessInteractionChannelOptions) {\n this.opts = options;\n }\n\n async run(prompt: string): Promise<void> {\n const shellExec: TShellExecFn =\n this.opts.shellExec ??\n ((command: string) =>\n execSync(command, { timeout: 5000, encoding: 'utf-8', stdio: 'pipe' }).trimEnd());\n\n const session = new InteractiveSession({\n cwd: this.opts.cwd,\n provider: this.opts.provider,\n permissionMode: this.opts.permissionMode ?? 'bypassPermissions',\n maxTurns: this.opts.maxTurns,\n sessionStore: this.opts.sessionStore,\n resumeSessionId: this.opts.resumeSessionId,\n forkSession: this.opts.forkSession,\n sessionName: this.opts.sessionName,\n bare: this.opts.bare || undefined,\n allowedTools: this.opts.allowedTools,\n deniedTools: this.opts.deniedTools,\n appendSystemPrompt: this.opts.appendSystemPrompt,\n ...(this.opts.persona !== undefined ? { persona: this.opts.persona } : {}),\n ...(this.opts.systemPrompt ? { systemPrompt: this.opts.systemPrompt } : {}),\n backgroundTaskRunners: this.opts.backgroundTaskRunners,\n subagentRunnerFactory: this.opts.subagentRunnerFactory,\n commandModules: this.opts.commandModules,\n commandHostAdapters: this.opts.commandHostAdapters,\n shellExec,\n agentName: this.opts.agentName,\n ...(this.opts.activePresetId !== undefined\n ? { activePresetId: this.opts.activePresetId }\n : {}),\n ...(this.opts.enableParallelSubagents !== undefined\n ? { enableParallelSubagents: this.opts.enableParallelSubagents }\n : {}),\n ...(this.opts.selfVerification !== undefined\n ? { selfVerification: this.opts.selfVerification }\n : {}),\n });\n\n const runner = createHeadlessRunner({ session, outputFormat: this.opts.outputFormat });\n this.exitCode = await runner.run(prompt);\n await session.shutdown({ reason: 'prompt_input_exit', message: 'Headless transport complete' });\n }\n\n getExitCode(): number {\n return this.exitCode;\n }\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index-CYl7ksS6.d.ts","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"mappings":";;;;;cAWa,aAAA,YAAyB,eAAA;EACpC,KAAA,CAAM,IAAA;EAGN,SAAA,CAAU,IAAA;EAGV,aAAA,CAAc,EAAA;EAGd,UAAA,CAAW,IAAA;EAGX,MAAA,CAAO,QAAA,WAAmB,OAAA;EAcpB,MAAA,CAAO,OAAA,YAAmB,YAAA,YAAmB,OAAA;EAcnD,OAAA,CAAQ,QAAA,WAAmB,QAAA;AAAA;;;cClDhB,WAAA,GAAe,KAAA,UAAe,MAAA,eAAiB,OAAO;;;KCEvD,aAAA;AAAA,UAEK,sBAAA;EACf,OAAA,EAAS,mBAAA;EACT,YAAA,EAAc,aAAa;AAAA;AAAA,iBAGb,oBAAA,CAAqB,OAAA,EAAS,sBAAA;EAC5C,GAAA,GAAM,MAAA,aAAmB,OAAO;AAAA;;;UCAjB,yBAAA;EH0BoC;EGxBnD,YAAA,EAAc,aAAa;EHHS;EGKpC,MAAA;AAAA;AAAA,iBAGc,uBAAA,CACd,OAAA,EAAS,yBAAA,GACR,iBAAA,CAAkB,mBAAA;EAAyB,WAAA;AAAA;;;UCE7B,kCAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,YAAA,EAAc,aAAA;EACd,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,YAAA,GAAe,wBAAA;EJdf;EIgBA,eAAA;EJbA;EIeA,WAAA;EACA,WAAA;EACA,IAAA;EACA,YAAA;EACA,WAAA;EACA,kBAAA;EACA,YAAA;EJDa;EIGb,SAAA;EJHmD;EIKnD,cAAA;EJSQ;EIPR,OAAA;EJOmC;EILnC,uBAAA;;EAEA,gBAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;AAAA;AAAA,cAGD,0BAAA;EAAA,iBACM,IAAA;EAAA,QACT,QAAA;cAEI,OAAA,EAAS,kCAAA;EAIf,GAAA,CAAI,MAAA,WAAiB,OAAO;EA2ClC,WAAA;AAAA"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index-E8Gx4-lc.d.ts","names":[],"sources":["../../src/headless/print-terminal.ts","../../src/headless/cli-input.ts","../../src/headless/headless-runner.ts","../../src/headless/headless-transport.ts","../../src/headless/HeadlessInteractionChannel.ts"],"mappings":";;;;;cAWa,aAAA,YAAyB,eAAA;EACpC,KAAA,CAAM,IAAA;EAGN,SAAA,CAAU,IAAA;EAGV,aAAA,CAAc,EAAA;EAGd,UAAA,CAAW,IAAA;EAGX,MAAA,CAAO,QAAA,WAAmB,OAAA;EAcpB,MAAA,CAAO,OAAA,YAAmB,YAAA,YAAmB,OAAA;EAcnD,OAAA,CAAQ,QAAA,WAAmB,QAAA;AAAA;;;cClDhB,WAAA,GAAe,KAAA,UAAe,MAAA,eAAiB,OAAO;;;KCEvD,aAAA;AAAA,UAEK,sBAAA;EACf,OAAA,EAAS,mBAAA;EACT,YAAA,EAAc,aAAa;AAAA;AAAA,iBAGb,oBAAA,CAAqB,OAAA,EAAS,sBAAA;EAC5C,GAAA,GAAM,MAAA,aAAmB,OAAO;AAAA;;;UCAjB,yBAAA;EH0BoC;EGxBnD,YAAA,EAAc,aAAa;EHHS;EGKpC,MAAA;AAAA;AAAA,iBAGc,uBAAA,CACd,OAAA,EAAS,yBAAA,GACR,iBAAA,CAAkB,mBAAA;EAAyB,WAAA;AAAA;;;UCE7B,kCAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,YAAA,EAAc,aAAA;EACd,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,YAAA,GAAe,wBAAA;EJdf;EIgBA,eAAA;EJbA;EIeA,WAAA;EACA,WAAA;EACA,IAAA;EACA,YAAA;EACA,WAAA;EACA,kBAAA;EACA,YAAA;EJDa;EIGb,SAAA;EJHmD;EIKnD,cAAA;EJSQ;EIPR,OAAA;EJOmC;EILnC,uBAAA;;EAEA,gBAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;AAAA;AAAA,cAGD,0BAAA;EAAA,iBACM,IAAA;EAAA,QACT,QAAA;cAEI,OAAA,EAAS,kCAAA;EAIf,GAAA,CAAI,MAAA,WAAiB,OAAO;EA2ClC,WAAA;AAAA"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/testing/scripted-provider.ts"],"mappings":";;;;KAYY,aAAA;EACN,IAAA;AAAA;EACA,SAAA,EAAW,aAAa;IAAG,IAAA;IAAc,IAAA,EAAM,MAAA;EAAA;AAAA;AAAA,UAEpC,iBAAA;EACf,QAAA,EAAU,WAAA;EAAA;EAEV,QAAA,EAAU,iBAAiB;AAAA;AAAA,iBAGb,sBAAA,CAAuB,KAAA,WAAgB,aAAA,KAAkB,iBAAiB"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../../src/testing/scripted-provider.ts"],"sourcesContent":["/**\n * Deterministic scripted provider for E2E tests (CLI-074).\n *\n * Replays a declared sequence of assistant turns through the REAL agent loop —\n * tool execution, permission gate, session persistence, and output transports all\n * run unmocked. Test-only: exported via the `@robota-sdk/agent-transport/testing`\n * subpath and never imported by runtime code.\n */\n\nimport type { IAIProvider, IRawProviderResponse, TUniversalMessage } from '@robota-sdk/agent-core';\n\n/** One scripted assistant turn: plain text or tool invocations. */\nexport type TScriptedTurn =\n | { text: string }\n | { toolCalls: ReadonlyArray<{ name: string; args: Record<string, unknown> }> };\n\nexport interface IScriptedProvider {\n provider: IAIProvider;\n /** Message arrays of every chat() call, in order, for request assertions. */\n requests: TUniversalMessage[][];\n}\n\nexport function createScriptedProvider(turns: readonly TScriptedTurn[]): IScriptedProvider {\n const requests: TUniversalMessage[][] = [];\n let cursor = 0;\n\n const provider: IAIProvider = {\n name: 'scripted-test-provider',\n version: 'test',\n async chat(messages: TUniversalMessage[]): Promise<TUniversalMessage> {\n requests.push([...messages]);\n const turn = turns[cursor];\n if (turn === undefined) {\n throw new Error(\n `Scripted provider: script exhausted at call ${cursor + 1} (script declares ${turns.length} turn(s)) — extend the script instead of relying on improvised responses`,\n );\n }\n cursor += 1;\n if ('text' in turn) {\n return {\n id: `scripted-${cursor}`,\n role: 'assistant',\n content: turn.text,\n state: 'complete',\n timestamp: new Date(),\n };\n }\n return {\n id: `scripted-${cursor}`,\n role: 'assistant',\n content: null,\n state: 'complete',\n timestamp: new Date(),\n toolCalls: turn.toolCalls.map((call, index) => ({\n id: `scripted-call-${cursor}-${index}`,\n type: 'function' as const,\n function: { name: call.name, arguments: JSON.stringify(call.args) },\n })),\n };\n },\n async generateResponse(): Promise<IRawProviderResponse> {\n return { content: 'scripted provider does not implement raw responses' };\n },\n supportsTools(): boolean {\n return true;\n },\n validateConfig(): boolean {\n return true;\n },\n };\n\n return { provider, requests };\n}\n"],"mappings":"AAsBA,SAAgB,EAAuB,EAAoD,CACzF,IAAM,EAAkC,CAAC,EACrC,EAAS,EA+Cb,MAAO,CAAE,SAAA,CA5CP,KAAM,yBACN,QAAS,OACT,MAAM,KAAK,EAA2D,CACpE,EAAS,KAAK,CAAC,GAAG,CAAQ,CAAC,EAC3B,IAAM,EAAO,EAAM,GACnB,GAAI,IAAS,IAAA,GACX,MAAU,MACR,+CAA+C,EAAS,EAAE,oBAAoB,EAAM,OAAO,yEAC7F,EAYF,MAVA,IAAU,EACN,SAAU,EACL,CACL,GAAI,YAAY,IAChB,KAAM,YACN,QAAS,EAAK,KACd,MAAO,WACP,UAAW,IAAI,IACjB,EAEK,CACL,GAAI,YAAY,IAChB,KAAM,YACN,QAAS,KACT,MAAO,WACP,UAAW,IAAI,KACf,UAAW,EAAK,UAAU,KAAK,EAAM,KAAW,CAC9C,GAAI,iBAAiB,EAAO,GAAG,IAC/B,KAAM,WACN,SAAU,CAAE,KAAM,EAAK,KAAM,UAAW,KAAK,UAAU,EAAK,IAAI,CAAE,CACpE,EAAE,CACJ,CACF,EACA,MAAM,kBAAkD,CACtD,MAAO,CAAE,QAAS,oDAAqD,CACzE,EACA,eAAyB,CACvB,MAAO,EACT,EACA,gBAA0B,CACxB,MAAO,EACT,CAGc,EAAG,UAAS,CAC9B"}
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Scripted provider fixture tests (CLI-074 TC-01).
|
|
3
|
-
*
|
|
4
|
-
* The fixture must replay declared turns in order, record every request's
|
|
5
|
-
* message array for assertions, and fail fast on script exhaustion — never
|
|
6
|
-
* silently improvise a response.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import { describe, expect, it } from 'vitest';
|
|
10
|
-
|
|
11
|
-
import { createScriptedProvider } from '../scripted-provider.js';
|
|
12
|
-
|
|
13
|
-
describe('createScriptedProvider (CLI-074)', () => {
|
|
14
|
-
it('TC-01: replays text turns in order and records requests', async () => {
|
|
15
|
-
const { provider, requests } = createScriptedProvider([
|
|
16
|
-
{ text: 'first answer' },
|
|
17
|
-
{ text: 'second answer' },
|
|
18
|
-
]);
|
|
19
|
-
|
|
20
|
-
const first = await provider.chat([
|
|
21
|
-
{ id: 'u1', role: 'user', content: 'hi', state: 'complete', timestamp: new Date() },
|
|
22
|
-
]);
|
|
23
|
-
const second = await provider.chat([
|
|
24
|
-
{ id: 'u2', role: 'user', content: 'again', state: 'complete', timestamp: new Date() },
|
|
25
|
-
]);
|
|
26
|
-
|
|
27
|
-
expect(first.role).toBe('assistant');
|
|
28
|
-
expect(first.content).toBe('first answer');
|
|
29
|
-
expect(second.content).toBe('second answer');
|
|
30
|
-
expect(requests).toHaveLength(2);
|
|
31
|
-
expect(requests[0]?.map((message) => message.content)).toContain('hi');
|
|
32
|
-
expect(requests[1]?.map((message) => message.content)).toContain('again');
|
|
33
|
-
});
|
|
34
|
-
|
|
35
|
-
it('TC-01: replays tool_use turns as assistant toolCalls', async () => {
|
|
36
|
-
const { provider } = createScriptedProvider([
|
|
37
|
-
{ toolCalls: [{ name: 'Read', args: { file_path: '/tmp/a.txt' } }] },
|
|
38
|
-
{ text: 'done reading' },
|
|
39
|
-
]);
|
|
40
|
-
|
|
41
|
-
const turn = await provider.chat([
|
|
42
|
-
{ id: 'u1', role: 'user', content: 'read it', state: 'complete', timestamp: new Date() },
|
|
43
|
-
]);
|
|
44
|
-
|
|
45
|
-
expect(turn.role).toBe('assistant');
|
|
46
|
-
if (turn.role !== 'assistant') throw new Error('unreachable');
|
|
47
|
-
expect(turn.content).toBeNull();
|
|
48
|
-
expect(turn.toolCalls).toHaveLength(1);
|
|
49
|
-
expect(turn.toolCalls?.[0]?.function.name).toBe('Read');
|
|
50
|
-
expect(JSON.parse(turn.toolCalls?.[0]?.function.arguments ?? '{}')).toEqual({
|
|
51
|
-
file_path: '/tmp/a.txt',
|
|
52
|
-
});
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
it('TC-01: throws on script exhaustion instead of improvising', async () => {
|
|
56
|
-
const { provider } = createScriptedProvider([{ text: 'only turn' }]);
|
|
57
|
-
|
|
58
|
-
await provider.chat([
|
|
59
|
-
{ id: 'u1', role: 'user', content: 'one', state: 'complete', timestamp: new Date() },
|
|
60
|
-
]);
|
|
61
|
-
|
|
62
|
-
await expect(
|
|
63
|
-
provider.chat([
|
|
64
|
-
{ id: 'u2', role: 'user', content: 'two', state: 'complete', timestamp: new Date() },
|
|
65
|
-
]),
|
|
66
|
-
).rejects.toThrow(/script exhausted/i);
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
it('supportsTools is true and validateConfig passes (agent-loop prerequisites)', () => {
|
|
70
|
-
const { provider } = createScriptedProvider([{ text: 'x' }]);
|
|
71
|
-
expect(provider.supportsTools()).toBe(true);
|
|
72
|
-
});
|
|
73
|
-
});
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Deterministic scripted provider for E2E tests (CLI-074).
|
|
3
|
-
*
|
|
4
|
-
* Replays a declared sequence of assistant turns through the REAL agent loop —
|
|
5
|
-
* tool execution, permission gate, session persistence, and output transports all
|
|
6
|
-
* run unmocked. Test-only: exported via the `@robota-sdk/agent-transport/testing`
|
|
7
|
-
* subpath and never imported by runtime code.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import type { IAIProvider, IRawProviderResponse, TUniversalMessage } from '@robota-sdk/agent-core';
|
|
11
|
-
|
|
12
|
-
/** One scripted assistant turn: plain text or tool invocations. */
|
|
13
|
-
export type TScriptedTurn =
|
|
14
|
-
| { text: string }
|
|
15
|
-
| { toolCalls: ReadonlyArray<{ name: string; args: Record<string, unknown> }> };
|
|
16
|
-
|
|
17
|
-
export interface IScriptedProvider {
|
|
18
|
-
provider: IAIProvider;
|
|
19
|
-
/** Message arrays of every chat() call, in order, for request assertions. */
|
|
20
|
-
requests: TUniversalMessage[][];
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export function createScriptedProvider(turns: readonly TScriptedTurn[]): IScriptedProvider {
|
|
24
|
-
const requests: TUniversalMessage[][] = [];
|
|
25
|
-
let cursor = 0;
|
|
26
|
-
|
|
27
|
-
const provider: IAIProvider = {
|
|
28
|
-
name: 'scripted-test-provider',
|
|
29
|
-
version: 'test',
|
|
30
|
-
async chat(messages: TUniversalMessage[]): Promise<TUniversalMessage> {
|
|
31
|
-
requests.push([...messages]);
|
|
32
|
-
const turn = turns[cursor];
|
|
33
|
-
if (turn === undefined) {
|
|
34
|
-
throw new Error(
|
|
35
|
-
`Scripted provider: script exhausted at call ${cursor + 1} (script declares ${turns.length} turn(s)) — extend the script instead of relying on improvised responses`,
|
|
36
|
-
);
|
|
37
|
-
}
|
|
38
|
-
cursor += 1;
|
|
39
|
-
if ('text' in turn) {
|
|
40
|
-
return {
|
|
41
|
-
id: `scripted-${cursor}`,
|
|
42
|
-
role: 'assistant',
|
|
43
|
-
content: turn.text,
|
|
44
|
-
state: 'complete',
|
|
45
|
-
timestamp: new Date(),
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
return {
|
|
49
|
-
id: `scripted-${cursor}`,
|
|
50
|
-
role: 'assistant',
|
|
51
|
-
content: null,
|
|
52
|
-
state: 'complete',
|
|
53
|
-
timestamp: new Date(),
|
|
54
|
-
toolCalls: turn.toolCalls.map((call, index) => ({
|
|
55
|
-
id: `scripted-call-${cursor}-${index}`,
|
|
56
|
-
type: 'function' as const,
|
|
57
|
-
function: { name: call.name, arguments: JSON.stringify(call.args) },
|
|
58
|
-
})),
|
|
59
|
-
};
|
|
60
|
-
},
|
|
61
|
-
async generateResponse(): Promise<IRawProviderResponse> {
|
|
62
|
-
return { content: 'scripted provider does not implement raw responses' };
|
|
63
|
-
},
|
|
64
|
-
supportsTools(): boolean {
|
|
65
|
-
return true;
|
|
66
|
-
},
|
|
67
|
-
validateConfig(): boolean {
|
|
68
|
-
return true;
|
|
69
|
-
},
|
|
70
|
-
};
|
|
71
|
-
|
|
72
|
-
return { provider, requests };
|
|
73
|
-
}
|