@av-pi-studio/server 0.0.115 → 0.0.117
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/README.md +8 -8
- package/dist/agent/index.d.ts +0 -1
- package/dist/agent/index.js +0 -1
- package/dist/agent/mcp-server.d.ts +3 -13
- package/dist/agent/mcp-server.js +2 -10
- package/dist/agent/provider-contract.d.ts +0 -7
- package/dist/agent/providers/mock/mock-provider.d.ts +12 -3
- package/dist/agent/providers/mock/mock-provider.js +46 -7
- package/dist/agent/providers/mock/stream-script.d.ts +28 -0
- package/dist/agent/providers/mock/stream-script.js +57 -0
- package/dist/agent/providers/pi/agent.js +0 -7
- package/dist/daemon/bootstrap.d.ts +18 -2
- package/dist/daemon/bootstrap.js +63 -13
- package/dist/daemon/dev-bootstrap.d.ts +7 -0
- package/dist/daemon/dev-bootstrap.js +34 -5
- package/dist/daemon/dev-main.js +5 -2
- package/dist/daemon/loopback.d.ts +4 -0
- package/dist/daemon/loopback.js +12 -0
- package/dist/daemon/main.js +4 -10
- package/dist/extensions/curated-packs.d.ts +0 -1
- package/dist/extensions/curated-packs.js +1 -6
- package/dist/extensions/sync-executor.js +1 -1
- package/dist/logging/index.d.ts +1 -0
- package/dist/logging/index.js +1 -0
- package/dist/logging/log-tap.d.ts +33 -0
- package/dist/logging/log-tap.js +233 -0
- package/dist/logging/logger.d.ts +6 -0
- package/dist/logging/logger.js +4 -0
- package/dist/observability/daemon-logs-rpc.d.ts +12 -0
- package/dist/observability/daemon-logs-rpc.js +17 -0
- package/dist/observability/daemon-logs-service.d.ts +67 -0
- package/dist/observability/daemon-logs-service.js +165 -0
- package/dist/observability/daemon-status-rpc.d.ts +12 -0
- package/dist/observability/daemon-status-rpc.js +21 -0
- package/dist/observability/daemon-status-service.d.ts +85 -0
- package/dist/observability/daemon-status-service.js +154 -0
- package/dist/test-support/auth-gated-rpc.d.ts +18 -0
- package/dist/test-support/auth-gated-rpc.js +80 -0
- package/dist/test-support/daemon-test-client.d.ts +43 -0
- package/dist/test-support/daemon-test-client.js +91 -0
- package/dist/test-support/external-fixtures-scenario.d.ts +30 -0
- package/dist/test-support/external-fixtures-scenario.js +223 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +7 -0
- package/dist/ws/session.d.ts +11 -0
- package/dist/ws/session.js +11 -0
- package/dist/ws/ws-server.js +2 -0
- package/package.json +3 -3
- package/dist/agent/permissions.d.ts +0 -71
- package/dist/agent/permissions.js +0 -132
package/README.md
CHANGED
|
@@ -97,7 +97,7 @@ node packages/server/dist/daemon/main.js
|
|
|
97
97
|
On startup the daemon prints its identity and readiness:
|
|
98
98
|
|
|
99
99
|
```
|
|
100
|
-
pi-studio daemon listening on http://
|
|
100
|
+
pi-studio daemon listening on http://127.0.0.1:6767
|
|
101
101
|
serverId: 3f2a…
|
|
102
102
|
home: /home/you/.pi-studio
|
|
103
103
|
provider: pi
|
|
@@ -107,7 +107,8 @@ pi-studio daemon listening on http://0.0.0.0:6767
|
|
|
107
107
|
|
|
108
108
|
By default the daemon:
|
|
109
109
|
|
|
110
|
-
- listens on **`
|
|
110
|
+
- listens on **`127.0.0.1:6767`** (loopback only). Override with `PI_STUDIO_LISTEN` or `config.json` `daemon.listen` (env wins); for LAN access use `0.0.0.0:6767` **together with `PI_STUDIO_PASSWORD`** — an unprotected non-loopback bind logs a warning
|
|
111
|
+
- (**Upgrade note:** earlier builds bound `0.0.0.0` by default. To keep LAN access set `PI_STUDIO_LISTEN=0.0.0.0:6767` or `daemon.listen`, together with `PI_STUDIO_PASSWORD`.)
|
|
111
112
|
- stores all state under **`$PI_STUDIO_HOME`** (default **`~/.pi-studio`**)
|
|
112
113
|
- writes logs to **`$PI_STUDIO_HOME/logs/`**
|
|
113
114
|
- uses the **`pi`** provider
|
|
@@ -129,7 +130,7 @@ curl http://127.0.0.1:6767/api/health
|
|
|
129
130
|
`src/daemon/dev-main.ts` is a development entry that wires only a **minimal handler subset**
|
|
130
131
|
(`dev-bootstrap.ts`: agent list/archive/delete, workspaces/projects listing, providers, file
|
|
131
132
|
read/diff, schedule listing — no terminals, git ops, worktrees, chat, loops, or relay), the mock
|
|
132
|
-
provider, and in-memory state, and binds `
|
|
133
|
+
provider, and in-memory state, and binds `127.0.0.1:6767` (override with `PI_STUDIO_LISTEN`; non-loopback logs a no-auth warning) with developer-friendly defaults. From the root:
|
|
133
134
|
|
|
134
135
|
```bash
|
|
135
136
|
npm run dev:daemon
|
|
@@ -171,7 +172,7 @@ All optional.
|
|
|
171
172
|
| Variable | Default | Purpose |
|
|
172
173
|
|----------|---------|---------|
|
|
173
174
|
| `PI_STUDIO_HOME` | `~/.pi-studio` | State + config + logs directory |
|
|
174
|
-
| `PI_STUDIO_LISTEN` | `
|
|
175
|
+
| `PI_STUDIO_LISTEN` | `127.0.0.1:6767` | Daemon listen address (`host:port`); falls back to `config.json` `daemon.listen`, then the default |
|
|
175
176
|
| `PI_STUDIO_PASSWORD` | _(unset)_ | Require this password for connections (bcrypt-checked) |
|
|
176
177
|
| `PI_STUDIO_HOSTNAMES` | `localhost,*.localhost` | Allowed `Host` header values (comma-separated, or `true` to allow all) |
|
|
177
178
|
| `PI_STUDIO_SERVER_ID` | _(persisted/generated)_ | Stable server identity |
|
|
@@ -185,7 +186,7 @@ All optional.
|
|
|
185
186
|
| `PI_STUDIO_SERVICE_PROXY_ENABLED` | _(unset)_ | Enable the service proxy (`1`/`true`/`yes`/`on`) |
|
|
186
187
|
| `PI_STUDIO_APP_BASE_URL` | `https://app.molagent.ai` | Pairing link origin (`daemon pair`) — set to your own web-client URL for self-hosted/local pairing |
|
|
187
188
|
|
|
188
|
-
> Literal IP addresses always pass the Host allowlist, so binding `0.0.0.0` and connecting via the
|
|
189
|
+
> Literal IP addresses always pass the Host allowlist, so binding `0.0.0.0` (opt-in) and connecting via the
|
|
189
190
|
> server's IP needs no extra config. To reach the daemon by **hostname**, add it to
|
|
190
191
|
> `PI_STUDIO_HOSTNAMES`.
|
|
191
192
|
|
|
@@ -266,7 +267,7 @@ All communication rides a **single WebSocket connection** per client.
|
|
|
266
267
|
- `rpc_error` — a correlated error response (carries the originating `requestId`).
|
|
267
268
|
|
|
268
269
|
A non-`hello` first frame closes the socket. RPC names follow a dotted convention —
|
|
269
|
-
`domain.provider.operation.direction` (e.g. `
|
|
270
|
+
`domain.provider.operation.direction` (e.g. `checkout.github.set_auto_merge.request`); legacy flat names
|
|
270
271
|
are accepted via aliases but never generated.
|
|
271
272
|
|
|
272
273
|
### Binary frames — terminal + file transfer
|
|
@@ -370,13 +371,12 @@ src/
|
|
|
370
371
|
dev-bootstrap.ts Dev handler wiring (local testing only).
|
|
371
372
|
orchestration-rpc.ts
|
|
372
373
|
|
|
373
|
-
agent/ Agent lifecycle, provider registry, timeline
|
|
374
|
+
agent/ Agent lifecycle, provider registry, timeline.
|
|
374
375
|
agent-manager.ts Single source of truth for agent state + FSM + persistence + broadcast.
|
|
375
376
|
agent-service.ts RPC handler wiring for agent operations.
|
|
376
377
|
provider-contract.ts AgentClient / AgentSession interfaces (the ONLY provider surface).
|
|
377
378
|
provider-registry.ts Register/resolve AgentClient by provider id.
|
|
378
379
|
timeline-store.ts Append/page/cursor the agent event log.
|
|
379
|
-
permissions.ts Park + resolve tool-call permission requests.
|
|
380
380
|
providers/pi/ Real Pi provider (spawn, JSONL transport, event mapper).
|
|
381
381
|
providers/mock/ In-process synthetic provider.
|
|
382
382
|
|
package/dist/agent/index.d.ts
CHANGED
|
@@ -12,7 +12,6 @@ export * from "./agent-service.js";
|
|
|
12
12
|
export * from "./timeline-rpc.js";
|
|
13
13
|
export * from "./session-operations.js";
|
|
14
14
|
export * from "./slash-command-operations.js";
|
|
15
|
-
export * from "./permissions.js";
|
|
16
15
|
export * from "./structured-generation.js";
|
|
17
16
|
export * from "./mcp-server.js";
|
|
18
17
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/agent/index.js
CHANGED
|
@@ -13,7 +13,6 @@ export * from "./agent-service.js";
|
|
|
13
13
|
export * from "./timeline-rpc.js";
|
|
14
14
|
export * from "./session-operations.js";
|
|
15
15
|
export * from "./slash-command-operations.js";
|
|
16
|
-
export * from "./permissions.js";
|
|
17
16
|
export * from "./structured-generation.js";
|
|
18
17
|
export * from "./mcp-server.js";
|
|
19
18
|
//# sourceMappingURL=index.js.map
|
|
@@ -15,7 +15,6 @@ import type { AgentUiPendingRequest, AgentUiResponse } from "@av-pi-studio/proto
|
|
|
15
15
|
* `appendSystemPrompt`, so no agent is ever handed a `--mcp-config`.
|
|
16
16
|
* Sprint-010/task-001 built this registry and deferred the transport as "a bootstrap step"; that
|
|
17
17
|
* step was never taken. Consequence: every tool here is dormant — including
|
|
18
|
-
* `list_pending_permissions`/`respond_to_permission` (sprint-010) and
|
|
19
18
|
* `list_pending_ui_requests`/`respond_to_ui_request` (sprint-066/task-005) — and the
|
|
20
19
|
* agent-to-agent orchestration in `features/subagents.md` has never run.
|
|
21
20
|
*
|
|
@@ -41,7 +40,7 @@ export interface McpToolContext {
|
|
|
41
40
|
callerAgentId?: string;
|
|
42
41
|
}
|
|
43
42
|
export type McpToolHandler<A> = (args: A, ctx: McpToolContext) => Promise<McpToolResult> | McpToolResult;
|
|
44
|
-
/** Backend the orchestration tools route to (AgentManager /
|
|
43
|
+
/** Backend the orchestration tools route to (AgentManager / provider services). */
|
|
45
44
|
export interface McpBackend {
|
|
46
45
|
/** Create an async child agent. Returns its id. */
|
|
47
46
|
createAgent(input: {
|
|
@@ -74,18 +73,9 @@ export interface McpBackend {
|
|
|
74
73
|
cancelAgent?(agentId: string): Promise<void>;
|
|
75
74
|
killAgent?(agentId: string): Promise<void>;
|
|
76
75
|
archiveAgent(agentId: string): Promise<void>;
|
|
77
|
-
listPendingPermissions(agentId?: string): Array<{
|
|
78
|
-
requestId: string;
|
|
79
|
-
agentId: string;
|
|
80
|
-
toolName?: string;
|
|
81
|
-
}>;
|
|
82
|
-
respondToPermission(requestId: string, response: unknown): {
|
|
83
|
-
resolved: boolean;
|
|
84
|
-
};
|
|
85
76
|
/** Extension UI (features/extension-ui-rpc.md § MCP mirror) — closes the deadlock where an
|
|
86
|
-
* orchestrating agent can't answer a child's extension questionnaire.
|
|
87
|
-
*
|
|
88
|
-
* distinct — see the tool registration below for why. */
|
|
77
|
+
* orchestrating agent can't answer a child's extension questionnaire. Its error vocabulary
|
|
78
|
+
* ("unknown_ui_request"/"unsupported") is documented at the tool registration below. */
|
|
89
79
|
listPendingUiRequests(agentId?: string): AgentUiPendingRequest[];
|
|
90
80
|
respondToUiRequest(requestId: string, response: AgentUiResponse): {
|
|
91
81
|
resolved: boolean;
|
package/dist/agent/mcp-server.js
CHANGED
|
@@ -17,7 +17,6 @@ import { PARENT_AGENT_ID_LABEL } from "./agent-manager.js";
|
|
|
17
17
|
* `appendSystemPrompt`, so no agent is ever handed a `--mcp-config`.
|
|
18
18
|
* Sprint-010/task-001 built this registry and deferred the transport as "a bootstrap step"; that
|
|
19
19
|
* step was never taken. Consequence: every tool here is dormant — including
|
|
20
|
-
* `list_pending_permissions`/`respond_to_permission` (sprint-010) and
|
|
21
20
|
* `list_pending_ui_requests`/`respond_to_ui_request` (sprint-066/task-005) — and the
|
|
22
21
|
* agent-to-agent orchestration in `features/subagents.md` has never run.
|
|
23
22
|
*
|
|
@@ -160,16 +159,9 @@ export class McpServer {
|
|
|
160
159
|
await b.archiveAgent(args.agentId);
|
|
161
160
|
return { ok: true };
|
|
162
161
|
});
|
|
163
|
-
// Permissions.
|
|
164
|
-
this.registerTool("list_pending_permissions", z.object({ agentId: z.string().optional() }), (args) => ({ ok: true, permissions: b.listPendingPermissions(args.agentId) }));
|
|
165
|
-
this.registerTool("respond_to_permission", z.object({ requestId: z.string(), response: z.unknown() }), (args) => {
|
|
166
|
-
const result = b.respondToPermission(args.requestId, args.response);
|
|
167
|
-
return result.resolved ? { ok: true } : { ok: false, error: "unknown_permission" };
|
|
168
|
-
});
|
|
169
162
|
// Extension UI (features/extension-ui-rpc.md § MCP mirror). Error vocabulary intentionally
|
|
170
|
-
// differs from
|
|
171
|
-
//
|
|
172
|
-
// result are distinct outcomes a caller must not conflate with "unknown" — collapsing a live
|
|
163
|
+
// differs from the WS side's `not_found`: a `resolved:false` with no `error` (never happens for
|
|
164
|
+
// this backend) and an `unsupported` result are distinct outcomes a caller must not conflate with "unknown" — collapsing a live
|
|
173
165
|
// dialog on a provider without `respondToUi` into `unknown_ui_request` would report it as
|
|
174
166
|
// gone when it is actually still answerable over WS by a human.
|
|
175
167
|
this.registerTool("list_pending_ui_requests", z.object({ agentId: z.string().optional() }), (args) => ({ ok: true, requests: b.listPendingUiRequests(args.agentId) }));
|
|
@@ -121,11 +121,6 @@ export interface ProviderRuntimeInfo {
|
|
|
121
121
|
modeId?: string;
|
|
122
122
|
extra?: Record<string, unknown>;
|
|
123
123
|
}
|
|
124
|
-
export interface PendingPermission {
|
|
125
|
-
requestId: string;
|
|
126
|
-
toolName?: string;
|
|
127
|
-
detail?: unknown;
|
|
128
|
-
}
|
|
129
124
|
/**
|
|
130
125
|
* One agent's todo list as a provider reports it: already sorted by id and capped to the protocol
|
|
131
126
|
* limits (`capAgentTodos`), so `truncated` has to travel with the tasks. The service adds the
|
|
@@ -213,8 +208,6 @@ export interface AgentSession {
|
|
|
213
208
|
getAvailableModes(): AgentModeDefinition[];
|
|
214
209
|
getCurrentMode(): string | null;
|
|
215
210
|
setMode(id: string): Promise<void>;
|
|
216
|
-
getPendingPermissions(): PendingPermission[];
|
|
217
|
-
respondToPermission(requestId: string, response: unknown): Promise<void>;
|
|
218
211
|
describePersistence(): PersistenceHandle | null;
|
|
219
212
|
interrupt(): Promise<void>;
|
|
220
213
|
close(): Promise<void>;
|
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
import type { AgentCapabilityFlags, AgentSessionConfig, AgentStreamEvent, AgentTodo } from "@av-pi-studio/protocol";
|
|
2
|
-
import type { AgentClient, AgentCommandDefinition, AgentCompactResult, AgentModeDefinition, AgentModelDefinition, AgentSession, AgentTodoList, CreateSessionOptions, LaunchContext,
|
|
2
|
+
import type { AgentClient, AgentCommandDefinition, AgentCompactResult, AgentModeDefinition, AgentModelDefinition, AgentSession, AgentTodoList, CreateSessionOptions, LaunchContext, PersistenceHandle, ProviderRuntimeInfo, ProviderUiRequest, ProviderUiResponse, Unsubscribe } from "../../provider-contract.js";
|
|
3
3
|
/**
|
|
4
4
|
* In-process `mock` provider (features/agent-providers.md § Provider entry — dev/test only). It
|
|
5
5
|
* implements the `AgentClient`/`AgentSession` contracts in memory and emits a scripted turn. Never
|
|
6
6
|
* user-selectable in production paths.
|
|
7
7
|
*/
|
|
8
8
|
export declare const MOCK_CAPABILITIES: AgentCapabilityFlags;
|
|
9
|
+
/** `fork` entry id that makes the mock rebind its persistence handle (sprint-083/task-002), so the
|
|
10
|
+
* real `agent_timeline_reset` broadcast path is reachable without a Pi session file. */
|
|
11
|
+
export declare const MOCK_REBIND_ENTRY_ID = "mock-rebind";
|
|
9
12
|
export interface MockSessionOptions {
|
|
10
13
|
/** Delay before a started turn completes (ms). Small but non-zero so `interrupt` can win. */
|
|
11
14
|
turnDelayMs?: number;
|
|
@@ -71,6 +74,10 @@ export declare class MockAgentSession implements AgentSession {
|
|
|
71
74
|
* lifecycle (start, 3 partials, end) synchronously — no timers between tool events — then the
|
|
72
75
|
* usual echo and `turn_completed`. `help` emits the recipe list and no tool events. */
|
|
73
76
|
private startToolScriptTurn;
|
|
77
|
+
/** `#stream ...` prompt (sprint-083/task-002): after `turnDelayMs`, emit the event kinds the
|
|
78
|
+
* normal mock turn never produces (`reasoning`, `turn_failed`, `error`) through the same
|
|
79
|
+
* `emit` path, ending on a terminal turn event. `help` emits the recipe list as assistant text. */
|
|
80
|
+
private startStreamScriptTurn;
|
|
74
81
|
/** Builds the raw (uncapped) task list for every recipe except `help`, which `startTodoScriptTurn`
|
|
75
82
|
* handles itself. `advance` reads `currentTodos` — the only recipe whose result depends on
|
|
76
83
|
* session state — everything else is a pure `todo-script.ts` builder. */
|
|
@@ -98,8 +105,6 @@ export declare class MockAgentSession implements AgentSession {
|
|
|
98
105
|
* silent clamping so the dev daemon exercises the same effective-level semantics. */
|
|
99
106
|
setThinkingOption(id: string): Promise<void>;
|
|
100
107
|
listThinkingLevels(): Promise<string[]>;
|
|
101
|
-
getPendingPermissions(): PendingPermission[];
|
|
102
|
-
respondToPermission(): Promise<void>;
|
|
103
108
|
onUiRequest(cb: (req: ProviderUiRequest) => void): Unsubscribe;
|
|
104
109
|
respondToUi(providerRequestId: string, response: ProviderUiResponse): void;
|
|
105
110
|
/** Test-only: push a scripted UI request to every subscriber, with sensible defaults for any
|
|
@@ -128,6 +133,10 @@ export declare class MockAgentSession implements AgentSession {
|
|
|
128
133
|
switchSession(): Promise<{
|
|
129
134
|
cancelled: boolean;
|
|
130
135
|
}>;
|
|
136
|
+
/** Fork generation: `fork(MOCK_REBIND_ENTRY_ID)` bumps it, which changes the native handle
|
|
137
|
+
* `describePersistence` reports — the condition under which `handleFork` resets the timeline and
|
|
138
|
+
* broadcasts `agent_timeline_reset`. Every other entry id leaves the handle alone (inert stub). */
|
|
139
|
+
private forkGeneration;
|
|
131
140
|
fork(entryId: string): Promise<{
|
|
132
141
|
text: string;
|
|
133
142
|
cancelled: boolean;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
2
|
import { capAgentTodos } from "../../agent-todos/todo-limits.js";
|
|
3
3
|
import { advanceTodos, blockedTodos, clearTodos, doneTodos, getTodoScriptHelpText, hugeTodos, literalTodos, manyTodos, parseTodoScript, planTodos, } from "./todo-script.js";
|
|
4
|
+
import { getStreamScriptHelpText, parseStreamScript, streamScriptEvents, } from "./stream-script.js";
|
|
4
5
|
import { getToolScriptHelpText, parseToolScript, toolScriptEvents, } from "./tool-script.js";
|
|
5
6
|
import { getUiScriptHelpText, parseUiScript } from "./ui-script.js";
|
|
6
7
|
/**
|
|
@@ -27,6 +28,9 @@ export const MOCK_CAPABILITIES = {
|
|
|
27
28
|
* that produced the data has closed, so clearing on close would defeat the whole point of this
|
|
28
29
|
* map. Bounded by distinct mock session ids created in the process. */
|
|
29
30
|
const mockTodosByHandle = new Map();
|
|
31
|
+
/** `fork` entry id that makes the mock rebind its persistence handle (sprint-083/task-002), so the
|
|
32
|
+
* real `agent_timeline_reset` broadcast path is reachable without a Pi session file. */
|
|
33
|
+
export const MOCK_REBIND_ENTRY_ID = "mock-rebind";
|
|
30
34
|
const MOCK_MODES = [
|
|
31
35
|
{ id: "default", label: "Default" },
|
|
32
36
|
{ id: "plan", label: "Plan" },
|
|
@@ -102,6 +106,9 @@ export class MockAgentSession {
|
|
|
102
106
|
const toolRecipe = parseToolScript(prompt);
|
|
103
107
|
if (toolRecipe !== null)
|
|
104
108
|
return this.startToolScriptTurn(toolRecipe);
|
|
109
|
+
const streamRecipe = parseStreamScript(prompt);
|
|
110
|
+
if (streamRecipe !== null)
|
|
111
|
+
return this.startStreamScriptTurn(streamRecipe);
|
|
105
112
|
const turnId = randomUUID();
|
|
106
113
|
this.activeTurn = turnId;
|
|
107
114
|
this.emit({ kind: "turn_started", turnId });
|
|
@@ -197,6 +204,33 @@ export class MockAgentSession {
|
|
|
197
204
|
}, this.turnDelayMs);
|
|
198
205
|
return Promise.resolve({ turnId });
|
|
199
206
|
}
|
|
207
|
+
/** `#stream ...` prompt (sprint-083/task-002): after `turnDelayMs`, emit the event kinds the
|
|
208
|
+
* normal mock turn never produces (`reasoning`, `turn_failed`, `error`) through the same
|
|
209
|
+
* `emit` path, ending on a terminal turn event. `help` emits the recipe list as assistant text. */
|
|
210
|
+
startStreamScriptTurn(recipe) {
|
|
211
|
+
const turnId = randomUUID();
|
|
212
|
+
this.activeTurn = turnId;
|
|
213
|
+
this.emit({ kind: "turn_started", turnId });
|
|
214
|
+
setTimeout(() => {
|
|
215
|
+
if (this.activeTurn !== turnId)
|
|
216
|
+
return;
|
|
217
|
+
if (recipe === "help") {
|
|
218
|
+
this.emit({
|
|
219
|
+
kind: "assistant_message",
|
|
220
|
+
messageId: randomUUID(),
|
|
221
|
+
text: getStreamScriptHelpText(),
|
|
222
|
+
final: true,
|
|
223
|
+
});
|
|
224
|
+
this.emit({ kind: "turn_completed", turnId });
|
|
225
|
+
}
|
|
226
|
+
else {
|
|
227
|
+
for (const event of streamScriptEvents(recipe, turnId, randomUUID()))
|
|
228
|
+
this.emit(event);
|
|
229
|
+
}
|
|
230
|
+
this.activeTurn = null;
|
|
231
|
+
}, this.turnDelayMs);
|
|
232
|
+
return Promise.resolve({ turnId });
|
|
233
|
+
}
|
|
200
234
|
/** Builds the raw (uncapped) task list for every recipe except `help`, which `startTodoScriptTurn`
|
|
201
235
|
* handles itself. `advance` reads `currentTodos` — the only recipe whose result depends on
|
|
202
236
|
* session state — everything else is a pure `todo-script.ts` builder. */
|
|
@@ -338,12 +372,6 @@ export class MockAgentSession {
|
|
|
338
372
|
listThinkingLevels() {
|
|
339
373
|
return Promise.resolve([...MOCK_THINKING_LEVELS]);
|
|
340
374
|
}
|
|
341
|
-
getPendingPermissions() {
|
|
342
|
-
return [];
|
|
343
|
-
}
|
|
344
|
-
respondToPermission() {
|
|
345
|
-
return Promise.resolve();
|
|
346
|
-
}
|
|
347
375
|
onUiRequest(cb) {
|
|
348
376
|
this.uiSubscribers.add(cb);
|
|
349
377
|
return () => this.uiSubscribers.delete(cb);
|
|
@@ -395,7 +423,12 @@ export class MockAgentSession {
|
|
|
395
423
|
return capped;
|
|
396
424
|
}
|
|
397
425
|
describePersistence() {
|
|
398
|
-
|
|
426
|
+
const generation = this.forkGeneration > 0 ? `:fork-${this.forkGeneration}` : "";
|
|
427
|
+
return {
|
|
428
|
+
provider: this.provider,
|
|
429
|
+
sessionId: this.id,
|
|
430
|
+
nativeHandle: `mock:${this.id}${generation}`,
|
|
431
|
+
};
|
|
399
432
|
}
|
|
400
433
|
// Slash-command operations (sprint-037) + command discovery (sprint-040): deterministic,
|
|
401
434
|
// dependency-free implementations for tests. `exportHtml` is deliberately omitted so callers
|
|
@@ -438,7 +471,13 @@ export class MockAgentSession {
|
|
|
438
471
|
switchSession() {
|
|
439
472
|
return Promise.resolve({ cancelled: false });
|
|
440
473
|
}
|
|
474
|
+
/** Fork generation: `fork(MOCK_REBIND_ENTRY_ID)` bumps it, which changes the native handle
|
|
475
|
+
* `describePersistence` reports — the condition under which `handleFork` resets the timeline and
|
|
476
|
+
* broadcasts `agent_timeline_reset`. Every other entry id leaves the handle alone (inert stub). */
|
|
477
|
+
forkGeneration = 0;
|
|
441
478
|
fork(entryId) {
|
|
479
|
+
if (entryId === MOCK_REBIND_ENTRY_ID)
|
|
480
|
+
this.forkGeneration += 1;
|
|
442
481
|
return Promise.resolve({ text: `mock forked text for ${entryId}`, cancelled: false });
|
|
443
482
|
}
|
|
444
483
|
getForkMessages() {
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { AgentStreamEvent } from "@av-pi-studio/protocol";
|
|
2
|
+
/**
|
|
3
|
+
* Scripted stream-event trigger for the mock provider (sprint-083/task-002). The normal mock turn
|
|
4
|
+
* only ever emits `turn_started` / `assistant_message` / `turn_completed`; typing a `#stream ...`
|
|
5
|
+
* prompt makes the mock emit the event kinds it otherwise never produces, so the whole wire family
|
|
6
|
+
* is exercisable (and fixturable) with no Pi and no credentials. Mirrors `#ui` / `#todo` / `#tool`:
|
|
7
|
+
* a pure, cheap-prefix-checked parser, a `help` recipe, and recognised-but-unknown input falling
|
|
8
|
+
* back to help rather than an ordinary echo.
|
|
9
|
+
*
|
|
10
|
+
* Grammar (also echoed verbatim by `#stream help`):
|
|
11
|
+
*
|
|
12
|
+
* #stream reasoning a `reasoning` block, then the usual echo and `turn_completed`
|
|
13
|
+
* #stream fail `turn_failed` instead of `turn_completed` (agent status becomes `error`)
|
|
14
|
+
* #stream error an `error` event, then `turn_failed`
|
|
15
|
+
* #stream help this list
|
|
16
|
+
*
|
|
17
|
+
* A bare `#stream` shows help.
|
|
18
|
+
*/
|
|
19
|
+
export declare const STREAM_SCRIPT_RECIPES: readonly ["reasoning", "fail", "error", "help"];
|
|
20
|
+
export type StreamScriptRecipe = (typeof STREAM_SCRIPT_RECIPES)[number];
|
|
21
|
+
export declare function getStreamScriptHelpText(): string;
|
|
22
|
+
/** Parses a `#stream ...` prompt into the recipe it names. Returns `null` when `prompt` is not a
|
|
23
|
+
* script. A bare `#stream` or an unrecognised recipe returns `"help"`. */
|
|
24
|
+
export declare function parseStreamScript(prompt: string): StreamScriptRecipe | null;
|
|
25
|
+
/** The events a non-`help` recipe emits after `turn_started`, in emission order. Every recipe ends
|
|
26
|
+
* on a terminal turn event so `AgentSession.run` resolves. */
|
|
27
|
+
export declare function streamScriptEvents(recipe: Exclude<StreamScriptRecipe, "help">, turnId: string, messageId: string): AgentStreamEvent[];
|
|
28
|
+
//# sourceMappingURL=stream-script.d.ts.map
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Scripted stream-event trigger for the mock provider (sprint-083/task-002). The normal mock turn
|
|
3
|
+
* only ever emits `turn_started` / `assistant_message` / `turn_completed`; typing a `#stream ...`
|
|
4
|
+
* prompt makes the mock emit the event kinds it otherwise never produces, so the whole wire family
|
|
5
|
+
* is exercisable (and fixturable) with no Pi and no credentials. Mirrors `#ui` / `#todo` / `#tool`:
|
|
6
|
+
* a pure, cheap-prefix-checked parser, a `help` recipe, and recognised-but-unknown input falling
|
|
7
|
+
* back to help rather than an ordinary echo.
|
|
8
|
+
*
|
|
9
|
+
* Grammar (also echoed verbatim by `#stream help`):
|
|
10
|
+
*
|
|
11
|
+
* #stream reasoning a `reasoning` block, then the usual echo and `turn_completed`
|
|
12
|
+
* #stream fail `turn_failed` instead of `turn_completed` (agent status becomes `error`)
|
|
13
|
+
* #stream error an `error` event, then `turn_failed`
|
|
14
|
+
* #stream help this list
|
|
15
|
+
*
|
|
16
|
+
* A bare `#stream` shows help.
|
|
17
|
+
*/
|
|
18
|
+
export const STREAM_SCRIPT_RECIPES = ["reasoning", "fail", "error", "help"];
|
|
19
|
+
const RECIPE_SET = new Set(STREAM_SCRIPT_RECIPES);
|
|
20
|
+
const HELP_TEXT = `#stream script recipes:
|
|
21
|
+
#stream reasoning a reasoning block, then the echo and turn_completed
|
|
22
|
+
#stream fail turn_failed instead of turn_completed (agent status becomes error)
|
|
23
|
+
#stream error an error event, then turn_failed
|
|
24
|
+
#stream help this list`;
|
|
25
|
+
export function getStreamScriptHelpText() {
|
|
26
|
+
return HELP_TEXT;
|
|
27
|
+
}
|
|
28
|
+
/** Parses a `#stream ...` prompt into the recipe it names. Returns `null` when `prompt` is not a
|
|
29
|
+
* script. A bare `#stream` or an unrecognised recipe returns `"help"`. */
|
|
30
|
+
export function parseStreamScript(prompt) {
|
|
31
|
+
const trimmed = prompt.trim();
|
|
32
|
+
if (!/^#stream(\s|$)/i.test(trimmed))
|
|
33
|
+
return null;
|
|
34
|
+
const rest = trimmed.slice("#stream".length).trim();
|
|
35
|
+
return RECIPE_SET.has(rest) ? rest : "help";
|
|
36
|
+
}
|
|
37
|
+
/** The events a non-`help` recipe emits after `turn_started`, in emission order. Every recipe ends
|
|
38
|
+
* on a terminal turn event so `AgentSession.run` resolves. */
|
|
39
|
+
export function streamScriptEvents(recipe, turnId, messageId) {
|
|
40
|
+
switch (recipe) {
|
|
41
|
+
case "reasoning":
|
|
42
|
+
return [
|
|
43
|
+
{ kind: "reasoning", text: "mock reasoning" },
|
|
44
|
+
{ kind: "reasoning", final: true },
|
|
45
|
+
{ kind: "assistant_message", messageId, text: "echo: #stream reasoning", final: true },
|
|
46
|
+
{ kind: "turn_completed", turnId },
|
|
47
|
+
];
|
|
48
|
+
case "fail":
|
|
49
|
+
return [{ kind: "turn_failed", turnId, error: "mock turn failure" }];
|
|
50
|
+
case "error":
|
|
51
|
+
return [
|
|
52
|
+
{ kind: "error", message: "mock stream error" },
|
|
53
|
+
{ kind: "turn_failed", turnId, error: "mock stream error" },
|
|
54
|
+
];
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=stream-script.js.map
|
|
@@ -326,13 +326,6 @@ class PiAgentSession {
|
|
|
326
326
|
this.mode = id;
|
|
327
327
|
return Promise.resolve();
|
|
328
328
|
}
|
|
329
|
-
getPendingPermissions() {
|
|
330
|
-
return [];
|
|
331
|
-
}
|
|
332
|
-
respondToPermission(requestId, response) {
|
|
333
|
-
this.transport.notify("respond_to_permission", { requestId, response });
|
|
334
|
-
return Promise.resolve();
|
|
335
|
-
}
|
|
336
329
|
onUiRequest(cb) {
|
|
337
330
|
this.uiSubscribers.add(cb);
|
|
338
331
|
return () => this.uiSubscribers.delete(cb);
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import type { Server as HttpServer } from "node:http";
|
|
2
|
+
import { LogTap } from "../logging/log-tap.js";
|
|
2
3
|
import { type Logger } from "../logging/logger.js";
|
|
3
4
|
import type { InstallSpawn } from "../extensions/sync-executor.js";
|
|
4
5
|
export interface DaemonOptions {
|
|
5
|
-
host
|
|
6
|
-
|
|
6
|
+
/** Bind host. Defaults to the host of `config.daemon.listen` (`PI_STUDIO_LISTEN` → config → loopback). */
|
|
7
|
+
host?: string;
|
|
8
|
+
/** Bind port. Defaults to the port of `config.daemon.listen`. */
|
|
9
|
+
port?: number;
|
|
7
10
|
/** Overrides `PI_STUDIO_HOME` (defaults to `~/.pi-studio`). */
|
|
8
11
|
home?: string;
|
|
9
12
|
/** Overrides the config path (defaults to `<home>/config.json`). */
|
|
@@ -15,6 +18,12 @@ export interface DaemonOptions {
|
|
|
15
18
|
* `PI_STUDIO_LOG_LEVEL` (default `info`). Tests inject `silentLogger()`.
|
|
16
19
|
*/
|
|
17
20
|
logger?: Logger;
|
|
21
|
+
/**
|
|
22
|
+
* Live log-stream tap (daemon log streaming). Defaults to a fresh `LogTap` attached to the
|
|
23
|
+
* logger the bootstrap builds itself; when `logger` is injected the caller must have passed the
|
|
24
|
+
* same tap to `createLogger({tap})` (an injected logger without it streams nothing).
|
|
25
|
+
*/
|
|
26
|
+
logTap?: LogTap;
|
|
18
27
|
/** Test-only injection for the preinstalled-extensions sync executor's process seam; production
|
|
19
28
|
* always spawns the bundled `pi` (`defaultInstallSpawn`). */
|
|
20
29
|
extensionsInstallSpawn?: InstallSpawn;
|
|
@@ -33,6 +42,13 @@ export interface DaemonHandle {
|
|
|
33
42
|
home: string;
|
|
34
43
|
provider: string;
|
|
35
44
|
logger: Logger;
|
|
45
|
+
/** The address actually bound. */
|
|
46
|
+
listen: {
|
|
47
|
+
host: string;
|
|
48
|
+
port: number;
|
|
49
|
+
};
|
|
50
|
+
/** True when bound beyond loopback with no password configured (a warning was logged). */
|
|
51
|
+
exposedWithoutPassword: boolean;
|
|
36
52
|
close(): Promise<void>;
|
|
37
53
|
}
|
|
38
54
|
/**
|