@markjaquith/agency 2.42.0 → 2.43.0

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,14 @@ 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.
+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.0",
   "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,10 @@ 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.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.",
+				},
 				plan: {
 					disable: true,
 				},