@markjaquith/agency 2.42.0 → 2.43.1

package/README.md

@@ -51,7 +51,7 @@ workbase/
   .agency/
     AGENTS.md              # managed Agency instructions
   .opencode/
-    opencode.jsonc         # managed instructions and whole-workbase reference
+    opencode.jsonc         # managed @agency subagent, instructions, and reference
   agency.json              # tracked config and portable repository declarations
   repos/                   # ignored local materializations
     frontend/              # bare Git repository or symlink
@@ -90,13 +90,16 @@ Agency-managed root `AGENTS.md` to `.agency/AGENTS.md` once the OpenCode config
 can load the hidden file. A customized root file, including a symlink, is
 preserved as user-owned content.
 
-The OpenCode config loads Agency's hidden instructions in addition to any
-user-owned root `AGENTS.md`, advertises the complete workbase as one portable
-reference, and replaces the built-in Plan agent with `agency-plan`. That planning
-agent can update `TASK.md`, `PHASE.md`, and `EPIC.md` while other edits remain
-disabled. OpenCode discovers the config from task and epic launch directories.
-Agents receive whole-workbase visibility from that reference. Bash and Agency
-operations must still follow the write authority reported by `agency context`.
+The OpenCode config defines an `@agency` subagent for delegated workbase
+orchestration, loads Agency's hidden instructions in addition to any user-owned
+root `AGENTS.md`, advertises the complete workbase as one portable reference,
+and replaces the built-in Plan agent with `agency-plan`. That planning agent can
+update `TASK.md`, `PHASE.md`, and `EPIC.md` while other edits remain disabled.
+When the subagent launches work in another agent, it verifies that the runner
+started and returns without waiting for the task to finish.
+OpenCode discovers the config from task and epic launch directories. Agents
+receive whole-workbase visibility from that reference. Bash and Agency operations
+must still follow the write authority reported by `agency context`.
 
 OpenCode also discovers a managed `/agency` command. Use `/agency status` for a
 read-only current-work summary, `/agency start [target]` to begin or resume work

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "2.42.0",
+  "version": "2.43.1",
   "description": "Manage agentic work across repositories with durable workbases",
   "keywords": [
     "agents",

package/src/cli.test.ts

@@ -1059,13 +1059,32 @@ status: open
 						env: environment,
 					})
 					expect(configProbe.exitCode).toBe(0)
-					expect(JSON.parse(configProbe.stdout.toString()).references).toEqual({
+					const effectiveConfig = JSON.parse(configProbe.stdout.toString())
+					expect(effectiveConfig.agent.agency).toMatchObject({
+						description: expect.stringContaining(
+							"Agency workbase orchestration",
+						),
+						mode: "subagent",
+					})
+					expect(effectiveConfig.references).toEqual({
 						workbase: {
 							path: "..",
 							description:
 								"Complete Agency workbase context; write authority still comes only from agency context",
 						},
 					})
+					const agencyProbe = Bun.spawnSync(
+						["opencode", "debug", "agent", "agency"],
+						{ cwd: contract.cwd, env: environment },
+					)
+					expect(agencyProbe.exitCode).toBe(0)
+					expect(JSON.parse(agencyProbe.stdout.toString())).toMatchObject({
+						name: "agency",
+						description: expect.stringContaining(
+							"Agency workbase orchestration",
+						),
+						mode: "subagent",
+					})
 					for (const document of documents) {
 						const read = Bun.spawnSync(
 							[

package/src/commands/init.test.ts

@@ -40,6 +40,11 @@ describe("init command", () => {
 		).text()
 		const config = JSON.parse(opencode.slice(opencode.indexOf("\n\n") + 2))
 		expect(config.instructions).toEqual([".agency/AGENTS.md"])
+		expect(config.agent.agency).toMatchObject({
+			description: expect.stringContaining("Agency workbase orchestration"),
+			mode: "subagent",
+			prompt: expect.stringContaining("agency context . --json"),
+		})
 		expect(config.agent.plan).toEqual({ disable: true })
 		expect(config.agent["agency-plan"]).toMatchObject({
 			mode: "primary",

package/src/services/IntegrationService.test.ts

@@ -138,11 +138,17 @@ describe("IntegrationService", () => {
 		expect(body).toContain(".opencode/command/agency.md")
 	})
 
-	test("configures Agency planning and complete workbase access", () => {
+	test("configures Agency agents with complete workbase access", () => {
 		const config = JSON.parse(managedBody(managedWorkbaseOpencode))
 
 		expect(config.instructions).toEqual([".agency/AGENTS.md"])
 		expect(config.agent).toEqual({
+			agency: {
+				description:
+					"Handles Agency workbase orchestration and workflow operations with the Agency CLI",
+				mode: "subagent",
+				prompt: expect.stringContaining("agency context . --json"),
+			},
 			plan: {
 				disable: true,
 			},
@@ -162,6 +168,16 @@ describe("IntegrationService", () => {
 				},
 			},
 		})
+		expect(config.agent.agency.model).toBeUndefined()
+		expect(config.agent.agency.permission).toBeUndefined()
+		expect(config.agent.agency.hidden).toBeUndefined()
+		expect(config.agent.agency.steps).toBeUndefined()
+		expect(config.agent.agency.prompt).toContain(
+			"verify that the runner started successfully",
+		)
+		expect(config.agent.agency.prompt).toContain(
+			"return without waiting for the task to finish",
+		)
 		expect(config.references).toEqual({
 			workbase: {
 				path: "..",

package/src/workbase/opencode-file.ts

@@ -16,6 +16,13 @@ const body = () =>
 			$schema: "https://opencode.ai/config.json",
 			instructions: [".agency/AGENTS.md"],
 			agent: {
+				agency: {
+					description:
+						"Handles Agency workbase orchestration and workflow operations with the Agency CLI",
+					mode: "subagent",
+					prompt:
+						"You are the Agency workflow specialist. Use the Agency CLI to handle delegated workbase orchestration and workflow operations. Always start with `agency context . --json`, follow the managed Agency instructions and reported authority, use Agency commands for durable mutations, and report the resulting state concisely. When delegated to start or kick off work in another agent, launch it, verify that the runner started successfully, and return without waiting for the task to finish.",
+				},
 				plan: {
 					disable: true,
 				},