@agimon-ai/doompi-task 0.0.1-alpha.75 → 0.0.1-alpha.76

package/dist/src/schemas/apiContracts.cjs

@@ -0,0 +1,51 @@
+let typebox = require("typebox");
+let _agimon_ai_doompi_core_api_contracts = require("@agimon-ai/doompi-core/api-contracts");
+//#region src/schemas/apiContracts.ts
+const S = typebox.Type.String();
+const N = typebox.Type.Number();
+const O = typebox.Type.Optional;
+const literals = (values) => typebox.Type.Union(values.map((value) => typebox.Type.Literal(value)));
+const TasksPayloadSchema = typebox.Type.Object({
+	tasks: typebox.Type.Array(typebox.Type.Object({
+		id: N,
+		subject: S,
+		description: O(S),
+		activeForm: O(S),
+		status: literals([
+			"pending",
+			"in_progress",
+			"completed",
+			"failed",
+			"deleted"
+		]),
+		blockedBy: typebox.Type.Array(N),
+		owner: O(S),
+		updatedAt: O(S),
+		delegation: O(typebox.Type.Object({
+			agent: O(S),
+			state: O(S)
+		}))
+	})),
+	rev: N
+});
+const apiContracts = (0, _agimon_ai_doompi_core_api_contracts.defineApiContract)({
+	version: 1,
+	http: [],
+	dynamic: [],
+	sockets: ["global", "workspace"].map((scope) => ({
+		id: "tasks.channel",
+		scope,
+		service: "doompi.hub.v1",
+		member: "task_graph",
+		kind: "channel",
+		direction: "server-to-client",
+		description: "Task graph channel payload.",
+		input: TasksPayloadSchema
+	}))
+});
+//#endregion
+exports.TasksPayloadSchema = TasksPayloadSchema;
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/src/schemas/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract"],"sources":["../../../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/doompi-core/api-contracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nexport const TasksPayloadSchema = Type.Object({\n  tasks: Type.Array(\n    Type.Object({\n      id: N,\n      subject: S,\n      description: O(S),\n      activeForm: O(S),\n      status: literals(['pending', 'in_progress', 'completed', 'failed', 'deleted']),\n      blockedBy: Type.Array(N),\n      owner: O(S),\n      updatedAt: O(S),\n      delegation: O(Type.Object({ agent: O(S), state: O(S) })),\n    }),\n  ),\n  rev: N,\n});\nexport const apiContracts = defineApiContract({\n  version: 1,\n  http: [],\n  dynamic: [],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'tasks.channel',\n    scope,\n    service: 'doompi.hub.v1',\n    member: 'task_graph',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Task graph channel payload.',\n    input: TasksPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAM,IAAIA,QAAAA,KAAK,OAAO;AACtB,MAAM,IAAIA,QAAAA,KAAK,OAAO;AACtB,MAAM,IAAIA,QAAAA,KAAK;AACf,MAAM,YAA8B,WAAgBA,QAAAA,KAAK,MAAM,OAAO,KAAK,UAAUA,QAAAA,KAAK,QAAQ,KAAK,CAAC,CAAC;AACzG,MAAa,qBAAqBA,QAAAA,KAAK,OAAO;CAC5C,OAAOA,QAAAA,KAAK,MACVA,QAAAA,KAAK,OAAO;EACV,IAAI;EACJ,SAAS;EACT,aAAa,EAAE,CAAC;EAChB,YAAY,EAAE,CAAC;EACf,QAAQ,SAAS;GAAC;GAAW;GAAe;GAAa;GAAU;EAAS,CAAC;EAC7E,WAAWA,QAAAA,KAAK,MAAM,CAAC;EACvB,OAAO,EAAE,CAAC;EACV,WAAW,EAAE,CAAC;EACd,YAAY,EAAEA,QAAAA,KAAK,OAAO;GAAE,OAAO,EAAE,CAAC;GAAG,OAAO,EAAE,CAAC;EAAE,CAAC,CAAC;CACzD,CAAC,CACH;CACA,KAAK;AACP,CAAC;AACD,MAAa,gBAAA,GAAeC,qCAAAA,kBAAAA,CAAkB;CAC5C,SAAS;CACT,MAAM,CAAC;CACP,SAAS,CAAC;CACV,SAAU,CAAC,UAAU,WAAW,CAAC,CAAW,KAAK,WAAW;EAC1D,IAAI;EACJ;EACA,SAAS;EACT,QAAQ;EACR,MAAM;EACN,WAAW;EACX,aAAa;EACb,OAAO;CACT,EAAE;AACJ,CAAC"}

package/dist/src/schemas/apiContracts.d.cts

@@ -0,0 +1,53 @@
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.d.ts
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.cts.map

package/dist/src/schemas/apiContracts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.cts","names":[],"sources":["../../../src/schemas/apiContracts.ts"],"mappings":";;qBAuBa"}

package/dist/src/schemas/apiContracts.d.mts

@@ -0,0 +1,53 @@
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.d.ts
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/src/schemas/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../../../src/schemas/apiContracts.ts"],"mappings":";;qBAuBa"}

package/dist/src/schemas/apiContracts.mjs

@@ -0,0 +1,49 @@
+import { Type } from "typebox";
+import { defineApiContract } from "@agimon-ai/doompi-core/api-contracts";
+//#region src/schemas/apiContracts.ts
+const S = Type.String();
+const N = Type.Number();
+const O = Type.Optional;
+const literals = (values) => Type.Union(values.map((value) => Type.Literal(value)));
+const TasksPayloadSchema = Type.Object({
+	tasks: Type.Array(Type.Object({
+		id: N,
+		subject: S,
+		description: O(S),
+		activeForm: O(S),
+		status: literals([
+			"pending",
+			"in_progress",
+			"completed",
+			"failed",
+			"deleted"
+		]),
+		blockedBy: Type.Array(N),
+		owner: O(S),
+		updatedAt: O(S),
+		delegation: O(Type.Object({
+			agent: O(S),
+			state: O(S)
+		}))
+	})),
+	rev: N
+});
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	dynamic: [],
+	sockets: ["global", "workspace"].map((scope) => ({
+		id: "tasks.channel",
+		scope,
+		service: "doompi.hub.v1",
+		member: "task_graph",
+		kind: "channel",
+		direction: "server-to-client",
+		description: "Task graph channel payload.",
+		input: TasksPayloadSchema
+	}))
+});
+//#endregion
+export { TasksPayloadSchema, apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/src/schemas/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../../../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/doompi-core/api-contracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nexport const TasksPayloadSchema = Type.Object({\n  tasks: Type.Array(\n    Type.Object({\n      id: N,\n      subject: S,\n      description: O(S),\n      activeForm: O(S),\n      status: literals(['pending', 'in_progress', 'completed', 'failed', 'deleted']),\n      blockedBy: Type.Array(N),\n      owner: O(S),\n      updatedAt: O(S),\n      delegation: O(Type.Object({ agent: O(S), state: O(S) })),\n    }),\n  ),\n  rev: N,\n});\nexport const apiContracts = defineApiContract({\n  version: 1,\n  http: [],\n  dynamic: [],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'tasks.channel',\n    scope,\n    service: 'doompi.hub.v1',\n    member: 'task_graph',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'Task graph channel payload.',\n    input: TasksPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAM,IAAI,KAAK,OAAO;AACtB,MAAM,IAAI,KAAK,OAAO;AACtB,MAAM,IAAI,KAAK;AACf,MAAM,YAA8B,WAAgB,KAAK,MAAM,OAAO,KAAK,UAAU,KAAK,QAAQ,KAAK,CAAC,CAAC;AACzG,MAAa,qBAAqB,KAAK,OAAO;CAC5C,OAAO,KAAK,MACV,KAAK,OAAO;EACV,IAAI;EACJ,SAAS;EACT,aAAa,EAAE,CAAC;EAChB,YAAY,EAAE,CAAC;EACf,QAAQ,SAAS;GAAC;GAAW;GAAe;GAAa;GAAU;EAAS,CAAC;EAC7E,WAAW,KAAK,MAAM,CAAC;EACvB,OAAO,EAAE,CAAC;EACV,WAAW,EAAE,CAAC;EACd,YAAY,EAAE,KAAK,OAAO;GAAE,OAAO,EAAE,CAAC;GAAG,OAAO,EAAE,CAAC;EAAE,CAAC,CAAC;CACzD,CAAC,CACH;CACA,KAAK;AACP,CAAC;AACD,MAAa,eAAe,kBAAkB;CAC5C,SAAS;CACT,MAAM,CAAC;CACP,SAAS,CAAC;CACV,SAAU,CAAC,UAAU,WAAW,CAAC,CAAW,KAAK,WAAW;EAC1D,IAAI;EACJ;EACA,SAAS;EACT,QAAQ;EACR,MAAM;EACN,WAAW;EACX,aAAa;EACb,OAAO;CACT,EAAE;AACJ,CAAC"}

package/dist/src/schemas/task.cjs

@@ -0,0 +1,130 @@
+require("../types/delegation.cjs");
+const require_task = require("../constants/task.cjs");
+let _agimon_ai_doompi_core_delegation = require("@agimon-ai/doompi-core/delegation");
+let typebox = require("typebox");
+//#region src/schemas/task.ts
+const TASK_ACTIONS = [
+	"upsert",
+	"list",
+	"get",
+	"delete",
+	"clear",
+	"assign",
+	"cancel"
+];
+const TASK_STATUSES = [
+	"pending",
+	"in_progress",
+	"completed",
+	"failed",
+	"deleted"
+];
+const TASK_CONTEXTS = ["fresh", "fork"];
+const TOOL_NAME = "task";
+const TOOL_LABEL = "Task";
+const ERR_REQUIRES_INTERACTIVE = "/tasks requires interactive mode";
+const MSG_NO_TASKS = "No tasks yet. Ask the agent to add some!";
+/**
+* Which top-level fields each action accepts.
+*
+* The params object is flat and shared across every action, so the schema alone
+* cannot express "upsert has no top-level id". That gap matters: a call like
+* `{"action":"upsert","id":3,"tasks":[{"status":"completed"}]}` would otherwise
+* silently create a duplicate task, because the entry itself carries no id.
+*/
+const TASK_ACTION_FIELDS = {
+	upsert: ["action", "tasks"],
+	list: [
+		"action",
+		"status",
+		"includeDeleted"
+	],
+	get: ["action", "id"],
+	delete: ["action", "id"],
+	clear: ["action"],
+	assign: ["action", "assignments"],
+	cancel: ["action", "id"]
+};
+function taskActionAcceptsField(action, field) {
+	return TASK_ACTION_FIELDS[action].includes(field);
+}
+/** Correction hint appended when a per-task field lands at the top level. */
+const MSG_UPSERT_FIELD_MISPLACED = "Per-task fields belong inside each tasks[] entry, not at the top level: {\"action\":\"upsert\",\"tasks\":[{\"id\":3,\"status\":\"completed\"}]}.";
+/**
+* A dependency target: an existing task id, or the `ref` of a task created
+* earlier in the same call.
+*/
+const DepTokenSchema = typebox.Type.Union([typebox.Type.Integer(), typebox.Type.String()]);
+/**
+* One entry of an upsert. `additionalProperties: false` is load-bearing: pi
+* validates tool arguments against this schema before `execute` runs, so a
+* stray `{"action":"update"}` inside an entry is rejected at the boundary.
+*/
+const TaskItemSchema = typebox.Type.Object({
+	id: typebox.Type.Optional(typebox.Type.Integer({ description: "Existing task id to change. Omit to create. An unknown id fails only that entry; it never creates." })),
+	ref: typebox.Type.Optional(typebox.Type.String({ description: "Temporary name for a task created by this entry, so a LATER entry in this array can list it in blockedBy. Must start with a letter; never stored." })),
+	subject: typebox.Type.Optional(typebox.Type.String({ description: "Short imperative subject. Required when the entry has no id; on an entry with an id it renames." })),
+	description: typebox.Type.Optional(typebox.Type.String({ description: "Long-form detail; becomes the brief handed to the subagent on assign." })),
+	activeForm: typebox.Type.Optional(typebox.Type.String({ description: "Present-continuous label shown while in_progress (e.g. 'writing tests')" })),
+	status: typebox.Type.Optional(typebox.Type.String({
+		enum: [...TASK_STATUSES],
+		description: "New entries default to pending and cannot start deleted; on an entry with an id the transition must be legal."
+	})),
+	blockedBy: typebox.Type.Optional(typebox.Type.Array(DepTokenSchema, { description: "Dependencies for a NEW entry: task ids, or refs of tasks created EARLIER in this array. On an entry with an id use addBlockedBy / removeBlockedBy instead." })),
+	addBlockedBy: typebox.Type.Optional(typebox.Type.Array(DepTokenSchema, { description: "Dependencies to add (ids or earlier refs). Additive; do not resend the full array." })),
+	removeBlockedBy: typebox.Type.Optional(typebox.Type.Array(DepTokenSchema, { description: "Dependencies to remove. Additive; do not resend the full array." })),
+	owner: typebox.Type.Optional(typebox.Type.String({ description: "Owner label; assign sets it to the subagent name." })),
+	metadata: typebox.Type.Optional(typebox.Type.Record(typebox.Type.String(), typebox.Type.Unknown(), { description: "Merged into the task; a null value deletes that key." }))
+}, { additionalProperties: false });
+/** One task-to-agent handoff in a native assignment batch. */
+const TaskAssignmentSchema = typebox.Type.Object({
+	id: typebox.Type.Integer({ description: "Pending, unblocked task id to delegate" }),
+	agent: typebox.Type.String({ description: "Exact discovered subagent name" }),
+	inlineAgent: typebox.Type.Optional(_agimon_ai_doompi_core_delegation.InlineAgentSchema),
+	instructions: typebox.Type.Optional(typebox.Type.String({ description: "Extra instructions appended to this delegated brief" })),
+	relevantFiles: typebox.Type.Optional(typebox.Type.Array(typebox.Type.String(), { description: `Files already read or located, relative to the working directory; at most 12 are used.` })),
+	priorFindings: typebox.Type.Optional(typebox.Type.String({ description: "Established facts this child should consume rather than re-derive" })),
+	model: typebox.Type.Optional(typebox.Type.String({ description: "Model override for this delegated run" })),
+	context: typebox.Type.Optional(typebox.Type.String({
+		enum: [...TASK_CONTEXTS],
+		description: "Starting context for this child: 'fresh' or 'fork'"
+	}))
+}, { additionalProperties: false });
+/**
+* Tool parameters. Every `description` doubles as LLM-facing prompt copy, so
+* wording changes here change model behaviour.
+*/
+const TaskParamsSchema = typebox.Type.Object({
+	action: typebox.Type.String({ enum: [...TASK_ACTIONS] }),
+	tasks: typebox.Type.Optional(typebox.Type.Array(TaskItemSchema, {
+		minItems: 1,
+		description: "upsert only. An entry with an id changes that task, an entry without an id creates one. Entries apply in array order, so a later entry can depend on an earlier one by ref."
+	})),
+	assignments: typebox.Type.Optional(typebox.Type.Array(TaskAssignmentSchema, {
+		minItems: 1,
+		description: "Required for assign, one entry per task, including when there is only one."
+	})),
+	id: typebox.Type.Optional(typebox.Type.Integer({ description: "Task id, for get, delete and cancel. Not accepted by upsert or assign: those carry ids inside tasks[] and assignments[] entries." })),
+	status: typebox.Type.Optional(typebox.Type.String({
+		enum: [...TASK_STATUSES],
+		description: "list only: return just the tasks in this status. To SET a status, upsert the task by id."
+	})),
+	includeDeleted: typebox.Type.Optional(typebox.Type.Boolean({ description: "list only: also return deleted tombstones. Default false." }))
+});
+//#endregion
+exports.COMMAND_NAME = require_task.COMMAND_NAME;
+exports.ERR_REQUIRES_INTERACTIVE = ERR_REQUIRES_INTERACTIVE;
+exports.MSG_NO_TASKS = MSG_NO_TASKS;
+exports.MSG_UPSERT_FIELD_MISPLACED = MSG_UPSERT_FIELD_MISPLACED;
+exports.TASK_ACTIONS = TASK_ACTIONS;
+exports.TASK_ACTION_FIELDS = TASK_ACTION_FIELDS;
+exports.TASK_CONTEXTS = TASK_CONTEXTS;
+exports.TASK_STATUSES = TASK_STATUSES;
+exports.TOOL_LABEL = TOOL_LABEL;
+exports.TOOL_NAME = TOOL_NAME;
+exports.TaskAssignmentSchema = TaskAssignmentSchema;
+exports.TaskItemSchema = TaskItemSchema;
+exports.TaskParamsSchema = TaskParamsSchema;
+exports.taskActionAcceptsField = taskActionAcceptsField;
+
+//# sourceMappingURL=task.cjs.map

package/dist/src/schemas/task.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.cjs","names":["Type","InlineAgentSchema"],"sources":["../../../src/schemas/task.ts"],"sourcesContent":["export { COMMAND_NAME } from '../constants/task';\nimport { InlineAgentSchema } from '@agimon-ai/doompi-core/delegation';\nimport { type Static, Type } from 'typebox';\n\nimport type { TaskAction } from '../models/task';\nimport { MAX_BRIEF_FILES } from '../types/delegation';\n\nexport const TASK_ACTIONS = ['upsert', 'list', 'get', 'delete', 'clear', 'assign', 'cancel'] as const;\nexport const TASK_STATUSES = ['pending', 'in_progress', 'completed', 'failed', 'deleted'] as const;\nexport const TASK_CONTEXTS = ['fresh', 'fork'] as const;\n\nexport const TOOL_NAME = 'task';\nexport const TOOL_LABEL = 'Task';\n\nexport const ERR_REQUIRES_INTERACTIVE = '/tasks requires interactive mode';\nexport const MSG_NO_TASKS = 'No tasks yet. Ask the agent to add some!';\n\n/**\n * Which top-level fields each action accepts.\n *\n * The params object is flat and shared across every action, so the schema alone\n * cannot express \"upsert has no top-level id\". That gap matters: a call like\n * `{\"action\":\"upsert\",\"id\":3,\"tasks\":[{\"status\":\"completed\"}]}` would otherwise\n * silently create a duplicate task, because the entry itself carries no id.\n */\nexport const TASK_ACTION_FIELDS = {\n  upsert: ['action', 'tasks'],\n  list: ['action', 'status', 'includeDeleted'],\n  get: ['action', 'id'],\n  delete: ['action', 'id'],\n  clear: ['action'],\n  assign: ['action', 'assignments'],\n  cancel: ['action', 'id'],\n} as const satisfies Record<TaskAction, readonly string[]>;\n\nexport function taskActionAcceptsField(action: TaskAction, field: string): boolean {\n  return (TASK_ACTION_FIELDS[action] as readonly string[]).includes(field);\n}\n\n/** Correction hint appended when a per-task field lands at the top level. */\nexport const MSG_UPSERT_FIELD_MISPLACED =\n  'Per-task fields belong inside each tasks[] entry, not at the top level: {\"action\":\"upsert\",\"tasks\":[{\"id\":3,\"status\":\"completed\"}]}.';\n\n/**\n * A dependency target: an existing task id, or the `ref` of a task created\n * earlier in the same call.\n */\nconst DepTokenSchema = Type.Union([Type.Integer(), Type.String()]);\n\n/**\n * One entry of an upsert. `additionalProperties: false` is load-bearing: pi\n * validates tool arguments against this schema before `execute` runs, so a\n * stray `{\"action\":\"update\"}` inside an entry is rejected at the boundary.\n */\nexport const TaskItemSchema = Type.Object(\n  {\n    id: Type.Optional(\n      Type.Integer({\n        description:\n          'Existing task id to change. Omit to create. An unknown id fails only that entry; it never creates.',\n      }),\n    ),\n    ref: Type.Optional(\n      Type.String({\n        description:\n          'Temporary name for a task created by this entry, so a LATER entry in this array can list it in blockedBy. Must start with a letter; never stored.',\n      }),\n    ),\n    subject: Type.Optional(\n      Type.String({\n        description: 'Short imperative subject. Required when the entry has no id; on an entry with an id it renames.',\n      }),\n    ),\n    description: Type.Optional(\n      Type.String({ description: 'Long-form detail; becomes the brief handed to the subagent on assign.' }),\n    ),\n    activeForm: Type.Optional(\n      Type.String({ description: \"Present-continuous label shown while in_progress (e.g. 'writing tests')\" }),\n    ),\n    status: Type.Optional(\n      Type.String({\n        enum: [...TASK_STATUSES],\n        description:\n          'New entries default to pending and cannot start deleted; on an entry with an id the transition must be legal.',\n      }),\n    ),\n    blockedBy: Type.Optional(\n      Type.Array(DepTokenSchema, {\n        description:\n          'Dependencies for a NEW entry: task ids, or refs of tasks created EARLIER in this array. On an entry with an id use addBlockedBy / removeBlockedBy instead.',\n      }),\n    ),\n    addBlockedBy: Type.Optional(\n      Type.Array(DepTokenSchema, {\n        description: 'Dependencies to add (ids or earlier refs). Additive; do not resend the full array.',\n      }),\n    ),\n    removeBlockedBy: Type.Optional(\n      Type.Array(DepTokenSchema, {\n        description: 'Dependencies to remove. Additive; do not resend the full array.',\n      }),\n    ),\n    owner: Type.Optional(Type.String({ description: 'Owner label; assign sets it to the subagent name.' })),\n    metadata: Type.Optional(\n      Type.Record(Type.String(), Type.Unknown(), {\n        description: 'Merged into the task; a null value deletes that key.',\n      }),\n    ),\n  },\n  { additionalProperties: false },\n);\n\n/** One task-to-agent handoff in a native assignment batch. */\nexport const TaskAssignmentSchema = Type.Object(\n  {\n    id: Type.Integer({ description: 'Pending, unblocked task id to delegate' }),\n    agent: Type.String({ description: 'Exact discovered subagent name' }),\n    inlineAgent: Type.Optional(InlineAgentSchema),\n    instructions: Type.Optional(Type.String({ description: 'Extra instructions appended to this delegated brief' })),\n    relevantFiles: Type.Optional(\n      Type.Array(Type.String(), {\n        description: `Files already read or located, relative to the working directory; at most ${MAX_BRIEF_FILES} are used.`,\n      }),\n    ),\n    priorFindings: Type.Optional(\n      Type.String({ description: 'Established facts this child should consume rather than re-derive' }),\n    ),\n    model: Type.Optional(Type.String({ description: 'Model override for this delegated run' })),\n    context: Type.Optional(\n      Type.String({\n        enum: [...TASK_CONTEXTS],\n        description: \"Starting context for this child: 'fresh' or 'fork'\",\n      }),\n    ),\n  },\n  { additionalProperties: false },\n);\n\n/**\n * Tool parameters. Every `description` doubles as LLM-facing prompt copy, so\n * wording changes here change model behaviour.\n */\nexport const TaskParamsSchema = Type.Object({\n  action: Type.String({ enum: [...TASK_ACTIONS] }),\n  tasks: Type.Optional(\n    Type.Array(TaskItemSchema, {\n      minItems: 1,\n      description:\n        'upsert only. An entry with an id changes that task, an entry without an id creates one. Entries apply in array order, so a later entry can depend on an earlier one by ref.',\n    }),\n  ),\n  assignments: Type.Optional(\n    Type.Array(TaskAssignmentSchema, {\n      minItems: 1,\n      description: 'Required for assign, one entry per task, including when there is only one.',\n    }),\n  ),\n  id: Type.Optional(\n    Type.Integer({\n      description:\n        'Task id, for get, delete and cancel. Not accepted by upsert or assign: those carry ids inside tasks[] and assignments[] entries.',\n    }),\n  ),\n  status: Type.Optional(\n    Type.String({\n      enum: [...TASK_STATUSES],\n      description: 'list only: return just the tasks in this status. To SET a status, upsert the task by id.',\n    }),\n  ),\n  includeDeleted: Type.Optional(\n    Type.Boolean({ description: 'list only: also return deleted tombstones. Default false.' }),\n  ),\n});\n\nexport type TaskItemParams = Static<typeof TaskItemSchema>;\nexport type TaskAssignmentParams = Static<typeof TaskAssignmentSchema>;\nexport type TaskParams = Static<typeof TaskParamsSchema>;\n"],"mappings":"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"}

package/dist/src/schemas/task.d.cts

@@ -0,0 +1,103 @@
+import { TaskAction } from "../models/task.cjs";
+import { COMMAND_NAME } from "../constants/task.cjs";
+import { Static, Type } from "typebox";
+//#region src/schemas/task.d.ts
+export declare const TASK_ACTIONS: readonly ['upsert', 'list', 'get', 'delete', 'clear', 'assign', 'cancel'];
+export declare const TASK_STATUSES: readonly ['pending', 'in_progress', 'completed', 'failed', 'deleted'];
+export declare const TASK_CONTEXTS: readonly ['fresh', 'fork'];
+export declare const TOOL_NAME = "task";
+export declare const TOOL_LABEL = "Task";
+export declare const ERR_REQUIRES_INTERACTIVE = "/tasks requires interactive mode";
+export declare const MSG_NO_TASKS = "No tasks yet. Ask the agent to add some!";
+/**
+ * Which top-level fields each action accepts.
+ *
+ * The params object is flat and shared across every action, so the schema alone
+ * cannot express "upsert has no top-level id". That gap matters: a call like
+ * `{"action":"upsert","id":3,"tasks":[{"status":"completed"}]}` would otherwise
+ * silently create a duplicate task, because the entry itself carries no id.
+ */
+export declare const TASK_ACTION_FIELDS: {
+  readonly upsert: readonly ["action", "tasks"];
+  readonly list: readonly ["action", "status", "includeDeleted"];
+  readonly get: readonly ["action", "id"];
+  readonly delete: readonly ["action", "id"];
+  readonly clear: readonly ["action"];
+  readonly assign: readonly ["action", "assignments"];
+  readonly cancel: readonly ["action", "id"];
+};
+export declare function taskActionAcceptsField(action: TaskAction, field: string): boolean;
+/** Correction hint appended when a per-task field lands at the top level. */
+export declare const MSG_UPSERT_FIELD_MISPLACED = "Per-task fields belong inside each tasks[] entry, not at the top level: {\"action\":\"upsert\",\"tasks\":[{\"id\":3,\"status\":\"completed\"}]}.";
+/**
+ * One entry of an upsert. `additionalProperties: false` is load-bearing: pi
+ * validates tool arguments against this schema before `execute` runs, so a
+ * stray `{"action":"update"}` inside an entry is rejected at the boundary.
+ */
+export declare const TaskItemSchema: Type.TObject<{
+  id: Type.TOptional<Type.TInteger>;
+  ref: Type.TOptional<Type.TString>;
+  subject: Type.TOptional<Type.TString>;
+  description: Type.TOptional<Type.TString>;
+  activeForm: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TString>;
+  blockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  addBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  removeBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  owner: Type.TOptional<Type.TString>;
+  metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+/** One task-to-agent handoff in a native assignment batch. */
+export declare const TaskAssignmentSchema: Type.TObject<{
+  id: Type.TInteger;
+  agent: Type.TString;
+  inlineAgent: Type.TOptional<Type.TObject<{
+    systemPrompt: Type.TString;
+  }>>;
+  instructions: Type.TOptional<Type.TString>;
+  relevantFiles: Type.TOptional<Type.TArray<Type.TString>>;
+  priorFindings: Type.TOptional<Type.TString>;
+  model: Type.TOptional<Type.TString>;
+  context: Type.TOptional<Type.TString>;
+}>;
+/**
+ * Tool parameters. Every `description` doubles as LLM-facing prompt copy, so
+ * wording changes here change model behaviour.
+ */
+export declare const TaskParamsSchema: Type.TObject<{
+  action: Type.TString;
+  tasks: Type.TOptional<Type.TArray<Type.TObject<{
+    id: Type.TOptional<Type.TInteger>;
+    ref: Type.TOptional<Type.TString>;
+    subject: Type.TOptional<Type.TString>;
+    description: Type.TOptional<Type.TString>;
+    activeForm: Type.TOptional<Type.TString>;
+    status: Type.TOptional<Type.TString>;
+    blockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    addBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    removeBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    owner: Type.TOptional<Type.TString>;
+    metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+  }>>>;
+  assignments: Type.TOptional<Type.TArray<Type.TObject<{
+    id: Type.TInteger;
+    agent: Type.TString;
+    inlineAgent: Type.TOptional<Type.TObject<{
+      systemPrompt: Type.TString;
+    }>>;
+    instructions: Type.TOptional<Type.TString>;
+    relevantFiles: Type.TOptional<Type.TArray<Type.TString>>;
+    priorFindings: Type.TOptional<Type.TString>;
+    model: Type.TOptional<Type.TString>;
+    context: Type.TOptional<Type.TString>;
+  }>>>;
+  id: Type.TOptional<Type.TInteger>;
+  status: Type.TOptional<Type.TString>;
+  includeDeleted: Type.TOptional<Type.TBoolean>;
+}>;
+export type TaskItemParams = Static<typeof TaskItemSchema>;
+export type TaskAssignmentParams = Static<typeof TaskAssignmentSchema>;
+export type TaskParams = Static<typeof TaskParamsSchema>;
+//#endregion
+export { COMMAND_NAME };
+//# sourceMappingURL=task.d.cts.map

package/dist/src/schemas/task.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.cts","names":[],"sources":["../../../src/schemas/task.ts"],"mappings":";;;;qBAOa;qBACA;qBACA;qBAEA;qBACA;qBAEA;qBACA;;;;;;;;;qBAUA;;;;;;;;;wBAUG,uBAAuB,QAAQ,YAAY;;qBAK9C;;;;;;qBAcA,gBAAc,KAAA;;;;;;;;;;;;;;qBA2Dd,sBAAoB,KAAA;;;;;;;;;;;;;;;;qBA6BpB,kBAAgB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAgCjB,iBAAiB,cAAc;YAC/B,uBAAuB,cAAc;YACrC,aAAa,cAAc"}

package/dist/src/schemas/task.d.mts

@@ -0,0 +1,103 @@
+import { TaskAction } from "../models/task.mjs";
+import { COMMAND_NAME } from "../constants/task.mjs";
+import { Static, Type } from "typebox";
+//#region src/schemas/task.d.ts
+export declare const TASK_ACTIONS: readonly ['upsert', 'list', 'get', 'delete', 'clear', 'assign', 'cancel'];
+export declare const TASK_STATUSES: readonly ['pending', 'in_progress', 'completed', 'failed', 'deleted'];
+export declare const TASK_CONTEXTS: readonly ['fresh', 'fork'];
+export declare const TOOL_NAME = "task";
+export declare const TOOL_LABEL = "Task";
+export declare const ERR_REQUIRES_INTERACTIVE = "/tasks requires interactive mode";
+export declare const MSG_NO_TASKS = "No tasks yet. Ask the agent to add some!";
+/**
+ * Which top-level fields each action accepts.
+ *
+ * The params object is flat and shared across every action, so the schema alone
+ * cannot express "upsert has no top-level id". That gap matters: a call like
+ * `{"action":"upsert","id":3,"tasks":[{"status":"completed"}]}` would otherwise
+ * silently create a duplicate task, because the entry itself carries no id.
+ */
+export declare const TASK_ACTION_FIELDS: {
+  readonly upsert: readonly ["action", "tasks"];
+  readonly list: readonly ["action", "status", "includeDeleted"];
+  readonly get: readonly ["action", "id"];
+  readonly delete: readonly ["action", "id"];
+  readonly clear: readonly ["action"];
+  readonly assign: readonly ["action", "assignments"];
+  readonly cancel: readonly ["action", "id"];
+};
+export declare function taskActionAcceptsField(action: TaskAction, field: string): boolean;
+/** Correction hint appended when a per-task field lands at the top level. */
+export declare const MSG_UPSERT_FIELD_MISPLACED = "Per-task fields belong inside each tasks[] entry, not at the top level: {\"action\":\"upsert\",\"tasks\":[{\"id\":3,\"status\":\"completed\"}]}.";
+/**
+ * One entry of an upsert. `additionalProperties: false` is load-bearing: pi
+ * validates tool arguments against this schema before `execute` runs, so a
+ * stray `{"action":"update"}` inside an entry is rejected at the boundary.
+ */
+export declare const TaskItemSchema: Type.TObject<{
+  id: Type.TOptional<Type.TInteger>;
+  ref: Type.TOptional<Type.TString>;
+  subject: Type.TOptional<Type.TString>;
+  description: Type.TOptional<Type.TString>;
+  activeForm: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TString>;
+  blockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  addBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  removeBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+  owner: Type.TOptional<Type.TString>;
+  metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+/** One task-to-agent handoff in a native assignment batch. */
+export declare const TaskAssignmentSchema: Type.TObject<{
+  id: Type.TInteger;
+  agent: Type.TString;
+  inlineAgent: Type.TOptional<Type.TObject<{
+    systemPrompt: Type.TString;
+  }>>;
+  instructions: Type.TOptional<Type.TString>;
+  relevantFiles: Type.TOptional<Type.TArray<Type.TString>>;
+  priorFindings: Type.TOptional<Type.TString>;
+  model: Type.TOptional<Type.TString>;
+  context: Type.TOptional<Type.TString>;
+}>;
+/**
+ * Tool parameters. Every `description` doubles as LLM-facing prompt copy, so
+ * wording changes here change model behaviour.
+ */
+export declare const TaskParamsSchema: Type.TObject<{
+  action: Type.TString;
+  tasks: Type.TOptional<Type.TArray<Type.TObject<{
+    id: Type.TOptional<Type.TInteger>;
+    ref: Type.TOptional<Type.TString>;
+    subject: Type.TOptional<Type.TString>;
+    description: Type.TOptional<Type.TString>;
+    activeForm: Type.TOptional<Type.TString>;
+    status: Type.TOptional<Type.TString>;
+    blockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    addBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    removeBlockedBy: Type.TOptional<Type.TArray<Type.TUnion<[Type.TInteger, Type.TString]>>>;
+    owner: Type.TOptional<Type.TString>;
+    metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+  }>>>;
+  assignments: Type.TOptional<Type.TArray<Type.TObject<{
+    id: Type.TInteger;
+    agent: Type.TString;
+    inlineAgent: Type.TOptional<Type.TObject<{
+      systemPrompt: Type.TString;
+    }>>;
+    instructions: Type.TOptional<Type.TString>;
+    relevantFiles: Type.TOptional<Type.TArray<Type.TString>>;
+    priorFindings: Type.TOptional<Type.TString>;
+    model: Type.TOptional<Type.TString>;
+    context: Type.TOptional<Type.TString>;
+  }>>>;
+  id: Type.TOptional<Type.TInteger>;
+  status: Type.TOptional<Type.TString>;
+  includeDeleted: Type.TOptional<Type.TBoolean>;
+}>;
+export type TaskItemParams = Static<typeof TaskItemSchema>;
+export type TaskAssignmentParams = Static<typeof TaskAssignmentSchema>;
+export type TaskParams = Static<typeof TaskParamsSchema>;
+//#endregion
+export { COMMAND_NAME };
+//# sourceMappingURL=task.d.mts.map

package/dist/src/schemas/task.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.mts","names":[],"sources":["../../../src/schemas/task.ts"],"mappings":";;;;qBAOa;qBACA;qBACA;qBAEA;qBACA;qBAEA;qBACA;;;;;;;;;qBAUA;;;;;;;;;wBAUG,uBAAuB,QAAQ,YAAY;;qBAK9C;;;;;;qBAcA,gBAAc,KAAA;;;;;;;;;;;;;;qBA2Dd,sBAAoB,KAAA;;;;;;;;;;;;;;;;qBA6BpB,kBAAgB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAgCjB,iBAAiB,cAAc;YAC/B,uBAAuB,cAAc;YACrC,aAAa,cAAc"}