@chopin-ai/harness-pi 0.0.0-stage → 0.2.0

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.
Files changed (51) hide show
  1. package/LICENSE +202 -0
  2. package/dist/acp.d.ts +42 -0
  3. package/dist/acp.js +122 -0
  4. package/dist/acp.js.map +1 -0
  5. package/dist/auth.d.ts +25 -0
  6. package/dist/auth.js +56 -0
  7. package/dist/auth.js.map +1 -0
  8. package/dist/backoff.d.ts +5 -0
  9. package/dist/backoff.js +13 -0
  10. package/dist/backoff.js.map +1 -0
  11. package/dist/bridge.d.ts +11 -0
  12. package/dist/bridge.js +259 -0
  13. package/dist/bridge.js.map +1 -0
  14. package/dist/http.d.ts +7 -0
  15. package/dist/http.js +73 -0
  16. package/dist/http.js.map +1 -0
  17. package/dist/index.d.ts +17 -0
  18. package/dist/index.js +11 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/layer.d.ts +8 -0
  21. package/dist/layer.js +84 -0
  22. package/dist/layer.js.map +1 -0
  23. package/dist/mcp.d.ts +24 -0
  24. package/dist/mcp.js +126 -0
  25. package/dist/mcp.js.map +1 -0
  26. package/dist/mode.d.ts +11 -0
  27. package/dist/mode.js +33 -0
  28. package/dist/mode.js.map +1 -0
  29. package/dist/pages.d.ts +8 -0
  30. package/dist/pages.js +12 -0
  31. package/dist/pages.js.map +1 -0
  32. package/dist/project-context.d.ts +18 -0
  33. package/dist/project-context.js +77 -0
  34. package/dist/project-context.js.map +1 -0
  35. package/dist/protocol.d.ts +247 -0
  36. package/dist/protocol.js +327 -0
  37. package/dist/protocol.js.map +1 -0
  38. package/dist/server.d.ts +25 -0
  39. package/dist/server.js +349 -0
  40. package/dist/server.js.map +1 -0
  41. package/dist/service.d.ts +96 -0
  42. package/dist/service.js +493 -0
  43. package/dist/service.js.map +1 -0
  44. package/dist/shell.d.ts +31 -0
  45. package/dist/shell.js +57 -0
  46. package/dist/shell.js.map +1 -0
  47. package/dist/submissions.d.ts +22 -0
  48. package/dist/submissions.js +33 -0
  49. package/dist/submissions.js.map +1 -0
  50. package/package.json +48 -3
  51. package/README.md +0 -3
package/dist/server.js ADDED
@@ -0,0 +1,349 @@
1
+ import { once } from "node:events";
2
+ import { createServer } from "node:http";
3
+ import { acceptWebSockets, createHost, forbidden, invalid } from "@earendil-works/chord";
4
+ import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
5
+ import { configure, InboxDoc } from "@earendil-works/pi-durable";
6
+ import { Type } from "typebox";
7
+ import { WebSocketServer } from "ws";
8
+ import { credentialOf } from "./auth.js";
9
+ import { httpHandler } from "./http.js";
10
+ import { ModeDoc, NameDoc } from "./mode.js";
11
+ import { userText } from "./acp.js";
12
+ import { Conversation, Conversations, HOST, ModeSchema, RunningSchema, SubmissionSchema } from "./protocol.js";
13
+ import { backoff } from "./backoff.js";
14
+ import { shellEntry } from "./shell.js";
15
+ import { lost, merge, outcomeOf, progressOf, RECENT_SUBMISSIONS } from "./submissions.js";
16
+ /** Serves the client protocol for `service`; every object belongs to the owner that asked for it. */
17
+ export function createAgentHost(service) {
18
+ const host = createHost({
19
+ name: HOST,
20
+ self: { kind: "host" },
21
+ principalKey: (principal) => (principal.kind === "owner" ? `owner:${principal.owner}` : "host"),
22
+ });
23
+ host.serve(Conversations, (_input, principal, self) => {
24
+ const owner = ownerOf(principal);
25
+ // A conversation made anywhere, such as by a task run, joins the list while it is held.
26
+ let unhear = () => { };
27
+ const harness = self.resource("harness", {
28
+ version: 1,
29
+ open: async () => {
30
+ const held = await service.hold(owner);
31
+ unhear = service.onConversation((maker, id) => {
32
+ if (maker === owner)
33
+ void host.root((root) => add(root, id)).catch(() => { });
34
+ });
35
+ return held;
36
+ },
37
+ close: () => {
38
+ unhear();
39
+ service.release(owner);
40
+ },
41
+ });
42
+ const ids = self.state("ids", Type.Array(Type.Number()), { init: () => service.conversations(owner) });
43
+ const add = (ctx, id) => ids.change(ctx, (draft) => {
44
+ if (!draft.includes(id))
45
+ draft.push(id);
46
+ });
47
+ return {
48
+ variant: "owner",
49
+ ids,
50
+ loaded: (ctx) => service.loaded(owner, durable(ctx)),
51
+ create: async (ctx) => {
52
+ const conversation = await service.newConversation(owner, durable(ctx));
53
+ add(ctx, conversation.id);
54
+ return conversation.id;
55
+ },
56
+ summaries: (ctx) => service.summaries(owner, durable(ctx)),
57
+ fork: async ({ conversation, at }, ctx) => {
58
+ const fork = await service.fork(owner, conversation, at, durable(ctx));
59
+ if (fork === undefined)
60
+ throw invalid("unknown_conversation", `no conversation ${conversation}`);
61
+ add(ctx, fork);
62
+ return fork;
63
+ },
64
+ };
65
+ });
66
+ host.serve(Conversation, ({ conversation: id }, principal, self) => {
67
+ const owner = ownerOf(principal);
68
+ const opened = self.resource("conversation", {
69
+ version: 1,
70
+ open: async () => {
71
+ const harness = await service.hold(owner);
72
+ try {
73
+ // Only a top-level conversation is the owner's to use; the harness's root and a task's own are not.
74
+ const conversation = await service.isTopLevel(owner, id) ? await harness.conversation(id, BACKGROUND_CONTEXT) : undefined;
75
+ if (conversation === undefined)
76
+ throw invalid("unknown_conversation", `no conversation ${id}`);
77
+ return { harness, conversation, view: await conversation.viewState(BACKGROUND_CONTEXT) };
78
+ }
79
+ catch (error) {
80
+ service.release(owner);
81
+ throw error;
82
+ }
83
+ },
84
+ close: ({ view }) => {
85
+ service.release(owner);
86
+ // What was started for this object stops with it: retries, and waits for submissions to end.
87
+ closed = true;
88
+ clearTimeout(retry);
89
+ closing.abort();
90
+ view.dispose();
91
+ },
92
+ });
93
+ let closed = false;
94
+ const closing = new AbortController();
95
+ const alive = withAbortSignal(closing.signal, BACKGROUND_CONTEXT);
96
+ let retry;
97
+ const view = self.state("view", Type.Unknown(), { init: () => opened.value.view.value });
98
+ const mode = self.state("mode", ModeSchema, {
99
+ init: async (ctx) => (await opened.value.harness.snapshot(ModeDoc, id, durable(ctx)))?.mode ?? "full",
100
+ });
101
+ const name = self.state("name", Type.String(), {
102
+ init: async (ctx) => (await opened.value.harness.snapshot(NameDoc, id, durable(ctx)))?.name ?? "",
103
+ });
104
+ // How submissions ended is the store's to say: every one the harness has not settled, the latest few, and any
105
+ // a client still waits on, however old.
106
+ const read = async (running) => {
107
+ const known = {};
108
+ for (const id of running)
109
+ known[String(id)] = lost("the store no longer has it");
110
+ for (const record of await service.submissions(owner, opened.value.conversation.id, RECENT_SUBMISSIONS, running)) {
111
+ known[String(record.id)] = outcomeOf(record);
112
+ if (known[String(record.id)]?.status === "pending")
113
+ awaitEnd(record.id);
114
+ }
115
+ return known;
116
+ };
117
+ // Submissions end as entries arrive or a run's inputs change; tokens streaming in between change neither.
118
+ let progress = "";
119
+ const submissions = self.state("submissions", Type.Record(Type.String(), SubmissionSchema), {
120
+ // A store that cannot be read yet leaves the list empty for a retry to fill, rather than failing the object.
121
+ init: async () => {
122
+ progress = progressOf(opened.value.view.value);
123
+ return read([]).catch(() => {
124
+ retryRead();
125
+ return {};
126
+ });
127
+ },
128
+ });
129
+ const unsettled = () => Object.keys(submissions.value).filter((id) => submissions.value[id]?.status === "pending").map(Number);
130
+ let reading = false;
131
+ let stale = false;
132
+ const retries = backoff(1_000, 30_000);
133
+ const reread = () => {
134
+ if (closed)
135
+ return;
136
+ if (reading)
137
+ return void (stale = true);
138
+ reading = true;
139
+ void (async () => {
140
+ do {
141
+ stale = false;
142
+ const known = await read(unsettled());
143
+ await host.root((root) => submissions.change(root, (draft) => merge(draft, known)));
144
+ } while (stale);
145
+ clearTimeout(retry);
146
+ retries.reset();
147
+ })().catch(retryRead).finally(() => void (reading = false));
148
+ };
149
+ // A store that cannot be read is tried again, waiting longer each time, for as long as anyone holds this object.
150
+ function retryRead() {
151
+ if (closed)
152
+ return;
153
+ clearTimeout(retry);
154
+ retry = setTimeout(reread, retries.next());
155
+ retry.unref();
156
+ }
157
+ self.on("view", opened, ({ view: source }) => source, (value, ctx) => {
158
+ view.replace(ctx, value);
159
+ const now = progressOf(value);
160
+ if (now === progress)
161
+ return;
162
+ progress = now;
163
+ reread();
164
+ });
165
+ // One command of the user's runs at a time, until it ends, esc stops it, or this object closes.
166
+ const running = self.state("running", RunningSchema, { init: () => null });
167
+ let stopCommand;
168
+ // Each unsettled submission is waited on once, so its end is read from the store however it comes about, with
169
+ // or without a new entry; however the wait ends, the store says how it did.
170
+ const awaited = new Set();
171
+ function awaitEnd(id, submission) {
172
+ if (closed || awaited.has(Number(id)))
173
+ return;
174
+ awaited.add(Number(id));
175
+ void Promise.resolve(submission ?? opened.value.harness.submission(id, alive))
176
+ .then((found) => found?.wait(alive))
177
+ // Settled or failed, the wait is over; a read that still finds the submission running starts another.
178
+ .finally(() => awaited.delete(Number(id)))
179
+ .then(reread, reread);
180
+ }
181
+ return {
182
+ variant: "owner",
183
+ view,
184
+ mode,
185
+ name,
186
+ submissions,
187
+ running,
188
+ submit: async ({ text, steer, request }, ctx) => {
189
+ service.touch(owner);
190
+ const submission = await opened.value.conversation.submit({
191
+ type: "input",
192
+ content: text,
193
+ ...(steer === true && { whenBusy: "steer" }),
194
+ ...(request !== undefined && { requestId: request }),
195
+ }, durable(ctx));
196
+ submissions.change(ctx, (draft) => void (draft[String(submission.id)] ??= { status: "pending" }));
197
+ awaitEnd(submission.id, submission);
198
+ reread();
199
+ return submission.id;
200
+ },
201
+ abort: async (_args, ctx) => {
202
+ service.touch(owner);
203
+ await opened.value.conversation.abort(durable(ctx));
204
+ },
205
+ stopCommand: async () => {
206
+ service.touch(owner);
207
+ stopCommand?.abort();
208
+ },
209
+ transcript: async (_args, ctx) => service.transcript(owner, opened.value.conversation, durable(ctx)),
210
+ shell: async ({ command, excluded = false }, ctx) => {
211
+ service.touch(owner);
212
+ if (stopCommand !== undefined)
213
+ throw invalid("command_running", "a command is already running; esc stops it");
214
+ const stop = (stopCommand = new AbortController());
215
+ const shown = { command, output: "", excluded };
216
+ running.replace(ctx, shown);
217
+ try {
218
+ const run = await service.shell(owner, command, (output) => host.root((root) => running.replace(root, { ...shown, output })), withAbortSignal(AbortSignal.any([stop.signal, closing.signal]), BACKGROUND_CONTEXT));
219
+ await opened.value.conversation.submit({ type: "write", entry: shellEntry({ command, excluded, ...run }) }, BACKGROUND_CONTEXT);
220
+ }
221
+ finally {
222
+ stopCommand = undefined;
223
+ await host.root((root) => running.replace(root, null)).catch(() => { });
224
+ }
225
+ },
226
+ withdraw: async (_args, ctx) => {
227
+ service.touch(owner);
228
+ const { harness, conversation } = opened.value;
229
+ const inbox = await harness.snapshot(InboxDoc, conversation.id, durable(ctx));
230
+ const texts = [];
231
+ for (const item of inbox?.items ?? []) {
232
+ if (item.mode === "write")
233
+ continue;
234
+ // One the agent took up meanwhile is no longer queued, and stays sent; one that cannot be withdrawn stays
235
+ // queued, so what was taken back is still given back.
236
+ const withdrawn = await harness.abortSubmission(item.id, durable(ctx), conversation.id).catch(() => undefined);
237
+ if (withdrawn === "aborted")
238
+ texts.push(userText(item.content));
239
+ }
240
+ reread();
241
+ return texts;
242
+ },
243
+ setModel: async ({ provider, modelId }, ctx) => {
244
+ service.touch(owner);
245
+ const problem = await service.modelProblem(owner, { provider, modelId });
246
+ if (problem !== undefined)
247
+ throw invalid("unusable_model", problem);
248
+ await opened.value.conversation.commit((tx) => configure(tx, opened.value.conversation.id, { model: { provider, modelId } }), durable(ctx));
249
+ },
250
+ setName: async ({ name: next }, ctx) => {
251
+ service.touch(owner);
252
+ await opened.value.conversation.commit(async (tx) => {
253
+ (await tx.doc(NameDoc, opened.value.conversation.id)).name = next;
254
+ }, durable(ctx));
255
+ name.replace(ctx, next);
256
+ },
257
+ setThinking: async ({ level }, ctx) => {
258
+ service.touch(owner);
259
+ const model = view.value.docs["pi.agent"]?.model;
260
+ const problem = model === undefined ? "the conversation has no model yet" : service.thinkingProblem(owner, model, level);
261
+ if (problem !== undefined)
262
+ throw invalid("unusable_thinking", problem);
263
+ await opened.value.conversation.commit((tx) => configure(tx, opened.value.conversation.id, { thinkingLevel: level }), durable(ctx));
264
+ },
265
+ compact: async ({ instructions }, ctx) => {
266
+ service.touch(owner);
267
+ await opened.value.conversation.compact(instructions, durable(ctx));
268
+ },
269
+ setMode: async ({ mode: next }, ctx) => {
270
+ service.touch(owner);
271
+ await opened.value.conversation.commit(async (tx) => {
272
+ (await tx.doc(ModeDoc, opened.value.conversation.id)).mode = next;
273
+ }, durable(ctx));
274
+ mode.replace(ctx, next);
275
+ },
276
+ };
277
+ });
278
+ return host;
279
+ }
280
+ /** Serves the client protocol over WebSocket, and the web app over HTTP, on one port. */
281
+ export async function listen(service, options) {
282
+ const host = createAgentHost(service);
283
+ let reachedAt = Date.now();
284
+ // Only someone who may use the service keeps it from being idle.
285
+ const authenticated = async (credential) => {
286
+ const principal = credential === undefined ? undefined : await options.authenticate(credential);
287
+ if (principal !== undefined)
288
+ reachedAt = Date.now();
289
+ return principal;
290
+ };
291
+ const handle = httpHandler(authenticated, options.web);
292
+ const http = createServer((request, response) => {
293
+ handle(request, response).catch(() => {
294
+ if (!response.headersSent)
295
+ response.writeHead(500);
296
+ response.end();
297
+ });
298
+ });
299
+ const sockets = new WebSocketServer({ server: http });
300
+ acceptWebSockets(sockets, host, {
301
+ principal: (request) => authenticated(sameOrigin(request) ? credentialOf(request) : undefined),
302
+ });
303
+ http.listen(options.port ?? 0, options.hostname ?? "127.0.0.1");
304
+ await once(http, "listening");
305
+ return {
306
+ port: http.address().port,
307
+ get clients() {
308
+ return sockets.clients.size;
309
+ },
310
+ get reachedAt() {
311
+ return reachedAt;
312
+ },
313
+ close: async () => {
314
+ for (const client of sockets.clients)
315
+ client.terminate();
316
+ await new Promise((resolve) => sockets.close(() => resolve()));
317
+ await new Promise((resolve) => http.close(() => resolve()));
318
+ await host.close();
319
+ },
320
+ };
321
+ }
322
+ /**
323
+ * Browsers attach the cookie to a WebSocket any page opens, and they always say which page that was. Only a page
324
+ * this service served may connect, at the address it was reached by or the one a proxy in front names; a page
325
+ * cannot set either header itself. Clients that are not browsers send no origin.
326
+ */
327
+ function sameOrigin(request) {
328
+ const origin = request.headers.origin;
329
+ if (origin === undefined)
330
+ return true;
331
+ const page = URL.parse(origin);
332
+ if (page === null)
333
+ return false;
334
+ const forwarded = request.headers["x-forwarded-host"];
335
+ const proxied = (Array.isArray(forwarded) ? forwarded[0] : forwarded)?.split(",")[0]?.trim();
336
+ // Read as the page's own scheme would, so case and a default port written out make no difference.
337
+ const named = (host) => host !== undefined && URL.parse(`${page.protocol}//${host}`)?.host === page.host;
338
+ return named(request.headers.host) || named(proxied);
339
+ }
340
+ /** Durable calls take the call's cancellation, not the call itself. */
341
+ function durable(ctx) {
342
+ return withAbortSignal(ctx.signal, BACKGROUND_CONTEXT);
343
+ }
344
+ function ownerOf(principal) {
345
+ if (principal.kind !== "owner")
346
+ throw forbidden();
347
+ return principal.owner;
348
+ }
349
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ import type { Context } from "@earendil-works/chord";
2
+ import { type Models } from "@earendil-works/pi-ai";
3
+ import { Harness, type AgentChange, type Conversation, type ConversationId, type Extension, type ModelRef, type SubmissionRecord } from "@earendil-works/pi-durable";
4
+ import { type Layer, type TaskRun, type TranscriptEntry } from "@chopin-ai/core";
5
+ import { type WorkspaceProvider } from "@chopin-ai/workspace";
6
+ import type { Loaded, Summary } from "./protocol.js";
7
+ import { type ShellRun } from "./shell.js";
8
+ /** Where the workspace image keeps the execution daemon. */
9
+ export declare const DAEMON_PATH = "/usr/local/bin/pi-env";
10
+ export interface AgentServiceOptions {
11
+ /** Holds one store per owner. It must not be reachable from any workspace. */
12
+ dataDir: string;
13
+ workspaces: WorkspaceProvider;
14
+ /** The models an owner's agent may use, carrying that owner's credentials. */
15
+ models: (owner: string) => Models;
16
+ /** What a new conversation of an owner runs with, such as its model; asked again for each, so a default may change. */
17
+ agent?: AgentChange | ((owner: string) => Promise<AgentChange | undefined>);
18
+ /** The portable layer every agent loads. */
19
+ layer?: Layer;
20
+ /** Installed after the coding tools and the layer. */
21
+ extensions?: readonly Extension[];
22
+ /** Failures that do not fail the call at hand, such as an unreachable MCP server. */
23
+ report?: (error: unknown) => void;
24
+ /** The execution daemon as the workspace runs it; the workspace image's by default. */
25
+ daemon?: string;
26
+ /** Stops workspaces whose owner has been idle this long, keeping their volumes; never when absent. */
27
+ reclaimAfterMs?: number;
28
+ }
29
+ /**
30
+ * Hosts one durable harness per owner. The agent and its store live here; its tools reach the owner's workspace
31
+ * only through the execution daemon, which starts the workspace on first use and again after it was reclaimed.
32
+ */
33
+ export declare class AgentService {
34
+ #private;
35
+ constructor(options: AgentServiceOptions);
36
+ /**
37
+ * The owner's harness, opened on first use; unfinished work resumes. Every caller shares the one opening, so it
38
+ * runs on the service's own context: a caller that gives up fails no other.
39
+ */
40
+ harness(owner: string): Promise<Harness>;
41
+ /** A new top-level conversation of the owner's agent, running with the configured agent choices. */
42
+ newConversation(owner: string, context: Context): Promise<Conversation>;
43
+ /**
44
+ * A fork of the owner's `conversation` at `entry`, made top-level like any other conversation of the owner;
45
+ * undefined when the owner has no such conversation.
46
+ */
47
+ fork(owner: string, conversation: number, entry: number, context: Context): Promise<number | undefined>;
48
+ /**
49
+ * A line about each of the owner's conversations, last changed first: its name, its first message, how many
50
+ * messages it holds, and when it began and last changed.
51
+ */
52
+ summaries(owner: string, context: Context): Promise<Summary[]>;
53
+ /** What the owner's agent loads besides its tools: the layer's instructions, skills and MCP servers, and the project's instructions. */
54
+ loaded(owner: string, context: Context): Promise<Loaded>;
55
+ /** A conversation of the owner's whole, as transcript lines. */
56
+ transcript(owner: string, conversation: Conversation, context: Context): Promise<TranscriptEntry[]>;
57
+ /** Runs a command of the owner's in their workspace, as the agent's shell tool runs its own. */
58
+ shell(owner: string, command: string, onOutput: (kept: string) => Promise<unknown>, context: Context): Promise<Omit<ShellRun, "command" | "excluded">>;
59
+ /** Why the owner's agent cannot think at `level` with `model`, or undefined when it can. */
60
+ thinkingProblem(owner: string, model: ModelRef, level: string): string | undefined;
61
+ /**
62
+ * Why the owner's agent cannot run with `model`: no such model, or no credentials for its provider; else undefined.
63
+ * A model the catalogs here do not know yet is looked for again in those kept on disk, which a client may have
64
+ * refreshed meanwhile.
65
+ */
66
+ modelProblem(owner: string, model: ModelRef): Promise<string | undefined>;
67
+ /** Hears of each conversation this service makes, until the returned function is called. */
68
+ onConversation(listener: (owner: string, conversation: number) => void): () => void;
69
+ /**
70
+ * Runs one prompt to its end in a new conversation of the owner's agent, and reports what happened in ACP together
71
+ * with what it changed in the workspace.
72
+ */
73
+ runTask(owner: string, prompt: string, context: Context): Promise<TaskRun>;
74
+ /**
75
+ * A conversation's input submissions as the owner's store records them: every one not settled yet, the latest
76
+ * `limit`, newest first, and those of `also` the store still has, however old.
77
+ */
78
+ submissions(owner: string, conversation: ConversationId, limit: number, also?: readonly number[]): Promise<SubmissionRecord[]>;
79
+ /** Owners whose agents still have work: a live task, an unsettled submission, or a command of theirs running. */
80
+ working(): Promise<string[]>;
81
+ /**
82
+ * The owner's top-level conversations, read from the store without holding up its writes; a subagent's conversation
83
+ * belongs to the task that made it.
84
+ */
85
+ conversations(owner: string): Promise<number[]>;
86
+ /** Whether `conversation` is one of the owner's top-level conversations, the only ones clients may use. */
87
+ isTopLevel(owner: string, conversation: number): Promise<boolean>;
88
+ /** The owner's harness for a client object, which gives it back with `release` once done with it. */
89
+ hold(owner: string): Promise<Harness>;
90
+ release(owner: string): void;
91
+ /** Marks the owner's agent as in use, for what reaches it other than through this service. */
92
+ touch(owner: string): void;
93
+ /** When the owner's agent was last in use, as idle reclaim reads it: an owner not seen since the start, from then. */
94
+ lastActive(owner: string): number;
95
+ close(context: Context): Promise<void>;
96
+ }