@grackle-ai/plugin-orchestration 0.97.0

package/README.md

@@ -0,0 +1,43 @@
+# @grackle-ai/plugin-orchestration
+
+Orchestration plugin for Grackle — tasks, personas, findings, and escalations.
+
+Separating orchestration from core means running Grackle without this plugin gives a clean "sessions + environments only" experience with no task DAG.
+
+## Usage
+
+```typescript
+import { createCorePlugin } from "@grackle-ai/server/core-plugin";
+import { createOrchestrationPlugin } from "@grackle-ai/plugin-orchestration";
+import { loadPlugins } from "@grackle-ai/plugin-sdk";
+
+const loaded = await loadPlugins(
+  [createCorePlugin(), createOrchestrationPlugin()],
+  pluginContext,
+);
+```
+
+## What This Plugin Contributes
+
+### gRPC Handlers (21 RPCs)
+
+| Group | Methods |
+|---|---|
+| Tasks | `listTasks`, `createTask`, `getTask`, `updateTask`, `startTask`, `completeTask`, `setWorkpad`, `resumeTask`, `stopTask`, `deleteTask` |
+| Personas | `listPersonas`, `createPersona`, `getPersona`, `updatePersona`, `deletePersona` |
+| Findings | `postFinding`, `queryFindings`, `getFinding` |
+| Escalations | `createEscalation`, `listEscalations`, `acknowledgeEscalation` |
+
+### Reconciliation Phases
+
+- **orphan-reparent** — re-parents child tasks whose parent session has ended
+
+### Event Subscribers
+
+- **sigchld** — handles agent process exit, updates task/session state
+- **escalation-auto** — auto-detects and routes escalations to the notification system
+- **orphan-reparent** — triggers reparenting on task lifecycle events
+
+## Dependencies
+
+Depends on the `"core"` plugin (declared via `dependencies: ["core"]`).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createOrchestrationPlugin } from "./orchestration-plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createOrchestrationPlugin } from "./orchestration-plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/orchestration-plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Orchestration plugin — contributes task, persona, finding, and escalation
+ * gRPC handlers, orphan-reparent reconciliation, and sigchld/escalation/orphan
+ * event subscribers.
+ *
+ * @module
+ */
+import type { GracklePlugin } from "@grackle-ai/plugin-sdk";
+/**
+ * Create the orchestration plugin that contributes task/persona/finding/escalation
+ * capabilities to the Grackle server.
+ *
+ * - **gRPC handlers**: All 21 orchestration RPCs (tasks, personas, findings, escalations)
+ * - **Reconciliation phases**: orphan-reparent
+ * - **Event subscribers**: sigchld, escalation-auto, orphan-reparent
+ *
+ * Depends on the "core" plugin.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export declare function createOrchestrationPlugin(): GracklePlugin;
+//# sourceMappingURL=orchestration-plugin.d.ts.map

package/dist/orchestration-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-plugin.d.ts","sourceRoot":"","sources":["../src/orchestration-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS5D;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,IAAI,aAAa,CA0BzD"}

package/dist/orchestration-plugin.js

@@ -0,0 +1,47 @@
+/**
+ * Orchestration plugin — contributes task, persona, finding, and escalation
+ * gRPC handlers, orphan-reparent reconciliation, and sigchld/escalation/orphan
+ * event subscribers.
+ *
+ * @module
+ */
+import { grackle } from "@grackle-ai/common";
+import { createOrchestrationCollector, createOrphanPhase, createSigchldSubscriber, createEscalationAutoSubscriber, createOrphanReparentSubscriber, } from "@grackle-ai/plugin-core";
+import { taskStore } from "@grackle-ai/database";
+/**
+ * Create the orchestration plugin that contributes task/persona/finding/escalation
+ * capabilities to the Grackle server.
+ *
+ * - **gRPC handlers**: All 21 orchestration RPCs (tasks, personas, findings, escalations)
+ * - **Reconciliation phases**: orphan-reparent
+ * - **Event subscribers**: sigchld, escalation-auto, orphan-reparent
+ *
+ * Depends on the "core" plugin.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export function createOrchestrationPlugin() {
+    return {
+        name: "orchestration",
+        dependencies: ["core"],
+        grpcHandlers: () => [{
+                service: grackle.Grackle,
+                handlers: createOrchestrationCollector().getHandlers(grackle.Grackle),
+            }],
+        reconciliationPhases: (ctx) => [
+            createOrphanPhase({
+                listAllTasks: () => taskStore.listTasks(),
+                reparentTask: (taskId, newParentTaskId) => {
+                    taskStore.reparentTask(taskId, newParentTaskId);
+                },
+                emit: ctx.emit,
+            }),
+        ],
+        eventSubscribers: (ctx) => [
+            createSigchldSubscriber(ctx),
+            createEscalationAutoSubscriber(ctx),
+            createOrphanReparentSubscriber(ctx),
+        ],
+    };
+}
+//# sourceMappingURL=orchestration-plugin.js.map

package/dist/orchestration-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-plugin.js","sourceRoot":"","sources":["../src/orchestration-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EAAE,8BAA8B,EAAE,8BAA8B,GACxF,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,YAAY,EAAE,CAAC,MAAM,CAAC;QAEtB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;gBACnB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,4BAA4B,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;aACtE,CAAC;QAEF,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;YAC7B,iBAAiB,CAAC;gBAChB,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE;gBACzC,YAAY,EAAE,CAAC,MAAc,EAAE,eAAuB,EAAQ,EAAE;oBAC9D,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;gBAClD,CAAC;gBACD,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC;SACH;QAED,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;YACzB,uBAAuB,CAAC,GAAG,CAAC;YAC5B,8BAA8B,CAAC,GAAG,CAAC;YACnC,8BAA8B,CAAC,GAAG,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@grackle-ai/plugin-orchestration",
+  "version": "0.97.0",
+  "description": "Orchestration plugin for Grackle — tasks, personas, findings, and escalations",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/plugin-orchestration"
+  },
+  "keywords": [
+    "grackle",
+    "plugin",
+    "orchestration"
+  ],
+  "homepage": "https://github.com/nick-pape/grackle#readme",
+  "bugs": {
+    "url": "https://github.com/nick-pape/grackle/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0 <24.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.5.0",
+    "@grackle-ai/common": "0.97.0",
+    "@grackle-ai/core": "0.97.0",
+    "@grackle-ai/plugin-core": "0.97.0",
+    "@grackle-ai/plugin-sdk": "0.97.0",
+    "@grackle-ai/database": "0.97.0"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.2.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}