agy-worker-mcp 0.3.1

package/dist/server/tools/logs.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { ValidationError } from '../../contract/errors.js';
+import { jobPaths } from '../../contract/paths.js';
+import { reconcile } from '../../broker/reconcile.js';
+import { readLinesFrom, tailLines } from '../../events/cursor.js';
+import { parseEventLines } from '../../events/parse.js';
+import { formatNormalized, normalizeParsed } from '../../events/normalize.js';
+import { getJob } from '../../store/jobs.js';
+import { loadJobDigest, renderDigest } from '../../trace/digest.js';
+import { errorReply, reply } from '../context.js';
+/**
+ * `agy_logs` — read events, normalized lines, or stderr by cursor or tail.
+ *
+ * MVP-essential rather than a later nicety: with jobs owned by no client, this is
+ * the only way a client that did not start a job can see what it is doing
+ * (see docs/tools.md).
+ */
+export const logsInput = z.object({
+    job_id: z.string(),
+    stream: z
+        .enum(['events', 'normalized', 'stderr', 'digest'])
+        .optional()
+        .describe('events = raw NDJSON, normalized = one readable line per meaningful step, digest = execution trace summary, stderr = raw stderr. Defaults to normalized.'),
+    after_cursor: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Byte offset from a previous call. Mutually exclusive with tail_lines.'),
+    tail_lines: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Last N lines. Mutually exclusive with after_cursor.'),
+    max_bytes: z.number().int().positive().optional(),
+});
+export async function handleLogs(ctx, input) {
+    try {
+        await reconcile(ctx.store);
+        if (input.stream === 'digest') {
+            if (input.after_cursor !== undefined || input.tail_lines !== undefined) {
+                throw new ValidationError({
+                    field: 'stream',
+                    value: { stream: input.stream, after_cursor: input.after_cursor, tail_lines: input.tail_lines },
+                    expected: 'stream=digest cannot be used with after_cursor or tail_lines',
+                });
+            }
+            const job = getJob(ctx.store, input.job_id);
+            const paths = jobPaths(ctx.paths, job.job_id);
+            const digest = loadJobDigest(paths.dir, job.cwd);
+            return reply({
+                job_id: job.job_id,
+                stream: 'digest',
+                digest,
+                text: renderDigest(digest),
+            });
+        }
+        if (input.after_cursor !== undefined && input.tail_lines !== undefined) {
+            throw new ValidationError({
+                field: 'after_cursor/tail_lines',
+                value: { after_cursor: input.after_cursor, tail_lines: input.tail_lines },
+                expected: 'only one of after_cursor or tail_lines, not both',
+            });
+        }
+        const job = getJob(ctx.store, input.job_id);
+        const paths = jobPaths(ctx.paths, job.job_id);
+        const stream = input.stream ?? 'normalized';
+        const maxBytes = input.max_bytes ?? ctx.limits.max_response_bytes;
+        const sourcePath = stream === 'stderr' ? paths.stderr : paths.events;
+        if (input.tail_lines !== undefined) {
+            const rawLines = tailLines(sourcePath, input.tail_lines, maxBytes);
+            const lines = stream === 'normalized'
+                ? normalizeParsed(parseEventLines(rawLines)).map(formatNormalized)
+                : rawLines;
+            return reply({ job_id: job.job_id, stream, lines });
+        }
+        const cursor = input.after_cursor ?? 0;
+        const read = readLinesFrom(sourcePath, cursor, { maxBytes });
+        const lines = stream === 'normalized'
+            ? normalizeParsed(parseEventLines(read.lines, cursor)).map(formatNormalized)
+            : read.lines;
+        return reply({
+            job_id: job.job_id,
+            stream,
+            lines,
+            cursor: read.nextCursor,
+            eof: read.eof,
+            truncated: read.truncated,
+        });
+    }
+    catch (e) {
+        return errorReply(e);
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/server/tools/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/server/tools/logs.ts"],"names":[],"mappings":"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"}

package/dist/server/tools/result.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { type ToolContext, type ToolReply } from '../context.js';
+/**
+ * `agy_result` — the full, paged result of a finished job.
+ *
+ * This is where the recovery loop lives: `verification.blockers[]` carries one
+ * entry per thing that stood in the way, each with `actionable` (can a
+ * different `agy_start` lift it) and `remedy` (what to change) — a gate
+ * denial's `required_rule` for `permissions.allow`, or the project ceiling's
+ * `sandboxed`/`read_roots` for a silent sandbox block that agy reported
+ * as SUCCESS. The original record behind each entry is kept verbatim in
+ * `detail`.
+ */
+export declare const resultInput: z.ZodObject<{
+    job_id: z.ZodString;
+    section: z.ZodOptional<z.ZodEnum<["summary", "agent_report", "verification", "response", "all"]>>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    job_id: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    section?: "summary" | "agent_report" | "verification" | "response" | "all" | undefined;
+}, {
+    job_id: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    section?: "summary" | "agent_report" | "verification" | "response" | "all" | undefined;
+}>;
+export type ResultInput = z.infer<typeof resultInput>;
+export declare function handleResult(ctx: ToolContext, input: ResultInput): Promise<ToolReply>;
+//# sourceMappingURL=result.d.ts.map

package/dist/server/tools/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/server/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAEnF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAatB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAerD,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAuD3F"}

package/dist/server/tools/result.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { jobPaths } from '../../contract/paths.js';
+import { reconcile } from '../../broker/reconcile.js';
+import { loadBrokerResult } from '../../broker/result.js';
+import { getJob } from '../../store/jobs.js';
+import { errorReply, reply } from '../context.js';
+/**
+ * `agy_result` — the full, paged result of a finished job.
+ *
+ * This is where the recovery loop lives: `verification.blockers[]` carries one
+ * entry per thing that stood in the way, each with `actionable` (can a
+ * different `agy_start` lift it) and `remedy` (what to change) — a gate
+ * denial's `required_rule` for `permissions.allow`, or the project ceiling's
+ * `sandboxed`/`read_roots` for a silent sandbox block that agy reported
+ * as SUCCESS. The original record behind each entry is kept verbatim in
+ * `detail`.
+ */
+export const resultInput = z.object({
+    job_id: z.string(),
+    section: z
+        .enum(['summary', 'agent_report', 'verification', 'response', 'all'])
+        .optional()
+        .describe('Which part to return. Defaults to summary.'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Character offset into the "response" section, for paging a long agent response.'),
+    limit: z.number().int().positive().optional().describe('Character count for the "response" section.'),
+});
+const DEFAULT_RESPONSE_LIMIT = 8000;
+function pageResponse(text, offset, limit) {
+    const full = text ?? '';
+    const slice = full.slice(offset, offset + limit);
+    return {
+        text: slice,
+        offset,
+        next_offset: offset + slice.length < full.length ? offset + slice.length : null,
+        total_length: full.length,
+    };
+}
+export async function handleResult(ctx, input) {
+    try {
+        await reconcile(ctx.store);
+        const job = getJob(ctx.store, input.job_id);
+        if (job.lifecycle !== 'finished') {
+            return reply({
+                job_id: job.job_id,
+                lifecycle: job.lifecycle,
+                message: 'job has not finished yet; call agy_wait or retry agy_result later',
+            });
+        }
+        const paths = jobPaths(ctx.paths, job.job_id);
+        const result = loadBrokerResult(paths);
+        if (!result) {
+            return reply({
+                job_id: job.job_id,
+                lifecycle: job.lifecycle,
+                message: 'job is finished but broker-result.json is not available yet; retry shortly',
+            });
+        }
+        const section = input.section ?? 'summary';
+        const offset = input.offset ?? 0;
+        const limit = input.limit ?? DEFAULT_RESPONSE_LIMIT;
+        if (section === 'summary') {
+            return reply({
+                job_id: result.job_id,
+                session_id: result.session_id,
+                lifecycle: result.lifecycle,
+                broker_summary: result.broker_summary,
+                agent_status: result.agent_status,
+                contract_status: result.contract_status,
+            });
+        }
+        if (section === 'agent_report') {
+            return reply({ job_id: result.job_id, agent_report: result.agent_report });
+        }
+        if (section === 'verification') {
+            return reply({ job_id: result.job_id, verification: result.verification });
+        }
+        if (section === 'response') {
+            return reply({ job_id: result.job_id, response: pageResponse(result.agent_report.response, offset, limit) });
+        }
+        // section === 'all'
+        return reply({
+            ...result,
+            agent_report: { ...result.agent_report, response: pageResponse(result.agent_report.response, offset, limit) },
+        });
+    }
+    catch (e) {
+        return errorReply(e);
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/server/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/server/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAoC,MAAM,eAAe,CAAA;AAEnF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;SACpE,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CACtG,CAAC,CAAA;AAIF,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAEnC,SAAS,YAAY,CAAC,IAAmB,EAAE,MAAc,EAAE,KAAa;IACtE,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAA;IAChD,OAAO;QACL,IAAI,EAAE,KAAK;QACX,MAAM;QACN,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC/E,YAAY,EAAE,IAAI,CAAC,MAAM;KAC1B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAgB,EAAE,KAAkB;IACrE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAE3C,IAAI,GAAG,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;gBACX,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,mEAAmE;aAC7E,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;gBACX,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,4EAA4E;aACtF,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,SAAS,CAAA;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,sBAAsB,CAAA;QAEnD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;gBACX,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;QAC9G,CAAC;QAED,oBAAoB;QACpB,OAAO,KAAK,CAAC;YACX,GAAG,MAAM;YACT,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;SAC9G,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/server/tools/send.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { type ToolContext, type ToolReply } from '../context.js';
+/**
+ * `agy_send` — queue a follow-up turn.
+ *
+ * Appends one line to `jobs/<id>/inbox.jsonl` and returns. It does not touch the
+ * process; the runner relays the line to agy's stdin.
+ *
+ * ⚠ Queued turns only queue. agy finishes the in-flight turn first and there is no
+ * way to interrupt or redirect it in print mode.
+ *
+ * ⚠ Does **not** touch `deadline_at`. The job's
+ * hard deadline is fixed once at `agy_start` from `timeout_ms` and this handler
+ * never patches it — see the comment on `EffectiveConfig.deadline_at` for why
+ * (short version: an ever-pushed-out deadline lets an actively-fed session hold
+ * its locks indefinitely, and nothing else would notice since `reconcile` only
+ * runs from a tool entry point). Use `idle_timeout_ms` (`agy_start`) if the goal
+ * is "end this session promptly once nobody is sending more turns" — that is a
+ * different axis (idle vs. total wall-clock) and is enforced by the runner
+ * itself, not by anything `agy_send` does here.
+ */
+export declare const sendInput: z.ZodObject<{
+    job_id: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    close: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    job_id: string;
+    text?: string | undefined;
+    close?: boolean | undefined;
+}, {
+    job_id: string;
+    text?: string | undefined;
+    close?: boolean | undefined;
+}>;
+export type SendInput = z.infer<typeof sendInput>;
+export declare function handleSend(ctx: ToolContext, input: SendInput): Promise<ToolReply>;
+//# sourceMappingURL=send.d.ts.map

package/dist/server/tools/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/server/tools/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAEnF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;EAOpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD,wBAAsB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAmCvF"}

package/dist/server/tools/send.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { ValidationError } from '../../contract/errors.js';
+import { jobPaths } from '../../contract/paths.js';
+import { reconcile } from '../../broker/reconcile.js';
+import { appendClose, appendUserTurn } from '../../runner/inbox.js';
+import { getJob } from '../../store/jobs.js';
+import { errorReply, reply } from '../context.js';
+/**
+ * `agy_send` — queue a follow-up turn.
+ *
+ * Appends one line to `jobs/<id>/inbox.jsonl` and returns. It does not touch the
+ * process; the runner relays the line to agy's stdin.
+ *
+ * ⚠ Queued turns only queue. agy finishes the in-flight turn first and there is no
+ * way to interrupt or redirect it in print mode.
+ *
+ * ⚠ Does **not** touch `deadline_at`. The job's
+ * hard deadline is fixed once at `agy_start` from `timeout_ms` and this handler
+ * never patches it — see the comment on `EffectiveConfig.deadline_at` for why
+ * (short version: an ever-pushed-out deadline lets an actively-fed session hold
+ * its locks indefinitely, and nothing else would notice since `reconcile` only
+ * runs from a tool entry point). Use `idle_timeout_ms` (`agy_start`) if the goal
+ * is "end this session promptly once nobody is sending more turns" — that is a
+ * different axis (idle vs. total wall-clock) and is enforced by the runner
+ * itself, not by anything `agy_send` does here.
+ */
+export const sendInput = z.object({
+    job_id: z.string(),
+    text: z.string().optional().describe('The follow-up turn. Omit when only closing.'),
+    close: z
+        .boolean()
+        .optional()
+        .describe('Close stdin after this turn, ending the agy process at EOF.'),
+});
+export async function handleSend(ctx, input) {
+    try {
+        await reconcile(ctx.store);
+        const job = getJob(ctx.store, input.job_id);
+        if (!input.text && !input.close) {
+            throw new ValidationError({
+                field: 'text/close',
+                value: input,
+                expected: 'at least one of "text" or "close: true"',
+            });
+        }
+        if (job.session_mode !== 'session') {
+            throw new ValidationError({
+                field: 'job_id',
+                value: input.job_id,
+                expected: 'a job started with session_mode "session" — a "oneshot" job closes stdin after its one turn and cannot accept follow-ups',
+            });
+        }
+        if (job.lifecycle === 'finished' || job.lifecycle === 'canceling') {
+            throw new ValidationError({
+                field: 'job_id',
+                value: input.job_id,
+                expected: `a job that is still live — job ${job.job_id} is already "${job.lifecycle}"`,
+            });
+        }
+        const paths = jobPaths(ctx.paths, job.job_id);
+        if (input.text)
+            appendUserTurn(paths.inbox, input.text);
+        if (input.close)
+            appendClose(paths.inbox);
+        return reply({ job_id: job.job_id, queued: true, closed: Boolean(input.close) });
+    }
+    catch (e) {
+        return errorReply(e);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/server/tools/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/server/tools/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAoC,MAAM,eAAe,CAAA;AAEnF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACnF,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAgB,EAAE,KAAgB;IACjE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAE3C,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CAAC;gBACxB,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,yCAAyC;aACpD,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CAAC;gBACxB,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,QAAQ,EAAE,0HAA0H;aACrI,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,SAAS,KAAK,UAAU,IAAI,GAAG,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CAAC;gBACxB,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,QAAQ,EAAE,kCAAkC,GAAG,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,GAAG;aACvF,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7C,IAAI,KAAK,CAAC,IAAI;YAAE,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACvD,IAAI,KAAK,CAAC,KAAK;YAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAEzC,OAAO,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAClF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/server/tools/sessions.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { type ToolContext, type ToolReply } from '../context.js';
+/**
+ * `agy_sessions` — list, inspect, or close agy conversations.
+ *
+ * A session is one agy conversation; a job is one turn. Resume is lossless
+ * (`--conversation`), so a finished oneshot job can always be continued later by
+ * passing its `session_id` to `agy_start`.
+ */
+export declare const sessionsInput: z.ZodObject<{
+    action: z.ZodOptional<z.ZodEnum<["list", "get", "close"]>>;
+    session_id: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<["active", "closed"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    state?: "active" | "closed" | undefined;
+    limit?: number | undefined;
+    session_id?: string | undefined;
+    action?: "close" | "list" | "get" | undefined;
+}, {
+    state?: "active" | "closed" | undefined;
+    limit?: number | undefined;
+    session_id?: string | undefined;
+    action?: "close" | "list" | "get" | undefined;
+}>;
+export type SessionsInput = z.infer<typeof sessionsInput>;
+export declare function handleSessions(ctx: ToolContext, input: SessionsInput): Promise<ToolReply>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/server/tools/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/server/tools/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAazD,wBAAsB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CA0B/F"}

package/dist/server/tools/sessions.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { ValidationError } from '../../contract/errors.js';
+import { reconcile } from '../../broker/reconcile.js';
+import { closeSession, getSession, listSessions } from '../../store/sessions.js';
+import { errorReply, reply } from '../context.js';
+/**
+ * `agy_sessions` — list, inspect, or close agy conversations.
+ *
+ * A session is one agy conversation; a job is one turn. Resume is lossless
+ * (`--conversation`), so a finished oneshot job can always be continued later by
+ * passing its `session_id` to `agy_start`.
+ */
+export const sessionsInput = z.object({
+    action: z.enum(['list', 'get', 'close']).optional().describe('Defaults to list.'),
+    session_id: z.string().optional().describe('Required for get and close.'),
+    state: z.enum(['active', 'closed']).optional(),
+    limit: z.number().int().positive().optional(),
+});
+function requireSessionId(input) {
+    if (!input.session_id) {
+        throw new ValidationError({
+            field: 'session_id',
+            value: input.session_id,
+            expected: 'a session_id, required for action "get" and "close"',
+        });
+    }
+    return input.session_id;
+}
+export async function handleSessions(ctx, input) {
+    try {
+        await reconcile(ctx.store);
+        const action = input.action ?? 'list';
+        if (action === 'list') {
+            const rows = listSessions(ctx.store, { state: input.state, limit: input.limit });
+            return reply({ sessions: rows, count: rows.length });
+        }
+        if (action === 'get') {
+            const sessionId = requireSessionId(input);
+            const row = getSession(ctx.store, sessionId);
+            if (!row) {
+                return errorReply(new Error(`no session "${sessionId}" in project ${ctx.paths.root}`));
+            }
+            return reply({ session: row });
+        }
+        // action === 'close'
+        const sessionId = requireSessionId(input);
+        const row = closeSession(ctx.store, sessionId);
+        return reply({ session: row });
+    }
+    catch (e) {
+        return errorReply(e);
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/server/tools/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../../src/server/tools/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAoC,MAAM,eAAe,CAAA;AAEnF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACjF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACzE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAA;AAIF,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC;YACxB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,KAAK,CAAC,UAAU;YACvB,QAAQ,EAAE,qDAAqD;SAChE,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAgB,EAAE,KAAoB;IACzE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAA;QAErC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;YAChF,OAAO,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QACtD,CAAC;QAED,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACzC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,UAAU,CAAC,IAAI,KAAK,CAAC,eAAe,SAAS,gBAAgB,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YACxF,CAAC;YACD,OAAO,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;QAChC,CAAC;QAED,qBAAqB;QACrB,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACzC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAC9C,OAAO,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/server/tools/start.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { type ToolContext, type ToolReply } from '../context.js';
+/**
+ * `agy_start` — begin a new job and return its `job_id` immediately.
+ *
+ * Never blocks. The job outlives this server process, so any client connected to
+ * the same project can pick it up with `agy_wait` / `agy_logs`.
+ *
+ * `dry_run: true` resolves everything — argv, policy, locks that *would* be
+ * taken — and returns the `EffectiveConfig` without spawning. Settling
+ * configuration this way costs no agy quota.
+ */
+export declare const startInput: z.ZodObject<{
+    prompt: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodEnum<["research_readonly", "general_worker"]>>;
+    model: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    mode: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    session_id: z.ZodOptional<z.ZodString>;
+    session_mode: z.ZodOptional<z.ZodEnum<["oneshot", "session"]>>;
+    permissions: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sandboxed: z.ZodOptional<z.ZodBoolean>;
+        read_roots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        deny?: string[] | undefined;
+        allow?: string[] | undefined;
+        read_roots?: string[] | undefined;
+        sandboxed?: boolean | undefined;
+    }, {
+        deny?: string[] | undefined;
+        allow?: string[] | undefined;
+        read_roots?: string[] | undefined;
+        sandboxed?: boolean | undefined;
+    }>>;
+    on_denial: z.ZodOptional<z.ZodEnum<["abort", "continue", "guide"]>>;
+    max_denials: z.ZodOptional<z.ZodNumber>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    idle_timeout_ms: z.ZodOptional<z.ZodNumber>;
+    expected_artifacts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    json_schema: z.ZodOptional<z.ZodString>;
+    verify_command: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    verify_timeout_ms: z.ZodOptional<z.ZodNumber>;
+    requested_by: z.ZodOptional<z.ZodString>;
+    parent_task_id: z.ZodOptional<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    expected_commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    cwd?: string | undefined;
+    profile?: "research_readonly" | "general_worker" | undefined;
+    on_denial?: "abort" | "continue" | "guide" | undefined;
+    max_denials?: number | undefined;
+    mode?: string | undefined;
+    session_id?: string | undefined;
+    session_mode?: "oneshot" | "session" | undefined;
+    requested_by?: string | undefined;
+    parent_task_id?: string | undefined;
+    model?: string | undefined;
+    effort?: "high" | "medium" | "low" | undefined;
+    idle_timeout_ms?: number | undefined;
+    permissions?: {
+        deny?: string[] | undefined;
+        allow?: string[] | undefined;
+        read_roots?: string[] | undefined;
+        sandboxed?: boolean | undefined;
+    } | undefined;
+    timeout_ms?: number | undefined;
+    expected_artifacts?: string[] | undefined;
+    json_schema?: string | undefined;
+    verify_command?: string | undefined;
+    verify_timeout_ms?: number | undefined;
+    dry_run?: boolean | undefined;
+    expected_commands?: string[] | undefined;
+}, {
+    prompt: string;
+    cwd?: string | undefined;
+    profile?: "research_readonly" | "general_worker" | undefined;
+    on_denial?: "abort" | "continue" | "guide" | undefined;
+    max_denials?: number | undefined;
+    mode?: string | undefined;
+    session_id?: string | undefined;
+    session_mode?: "oneshot" | "session" | undefined;
+    requested_by?: string | undefined;
+    parent_task_id?: string | undefined;
+    model?: string | undefined;
+    effort?: "high" | "medium" | "low" | undefined;
+    idle_timeout_ms?: number | undefined;
+    permissions?: {
+        deny?: string[] | undefined;
+        allow?: string[] | undefined;
+        read_roots?: string[] | undefined;
+        sandboxed?: boolean | undefined;
+    } | undefined;
+    timeout_ms?: number | undefined;
+    expected_artifacts?: string[] | undefined;
+    json_schema?: string | undefined;
+    verify_command?: string | undefined;
+    verify_timeout_ms?: number | undefined;
+    dry_run?: boolean | undefined;
+    expected_commands?: string[] | undefined;
+}>;
+export type StartInput = z.infer<typeof startInput>;
+export declare function handleStart(ctx: ToolContext, input: StartInput): Promise<ToolReply>;
+//# sourceMappingURL=start.d.ts.map

package/dist/server/tools/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/server/tools/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8BvB,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAGnF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0GrB,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AASnD,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAoZzF"}