@grackle-ai/plugin-core 0.135.0 → 0.135.1

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export type { OrphanPhaseDeps } from "./orphan-phase.js";
 export { lifecycleCleanupPhase } from "./lifecycle-cleanup.js";
 export { createEnvironmentReconciliationPhase } from "./environment-reconciliation.js";
 export type { EnvironmentReconciliationDeps } from "./environment-reconciliation.js";
+export { createSubagentReconciliationPhase } from "./subagent-reconciliation.js";
+export type { SubagentReconciliationDeps } from "./subagent-reconciliation.js";
 export { setLoadedPluginNames, PLUGIN_REGISTRY } from "./plugin-registry.js";
 export type { PluginRegistryEntry } from "./plugin-registry.js";
 export { killSessionAndCleanup } from "./grpc-shared.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oCAAoC,EAAE,MAAM,iCAAiC,CAAC;AACvF,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAGrF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oCAAoC,EAAE,MAAM,iCAAiC,CAAC;AACvF,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG/E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export { createDispatchPhase } from "./dispatch-phase.js";
 export { createOrphanPhase } from "./orphan-phase.js";
 export { lifecycleCleanupPhase } from "./lifecycle-cleanup.js";
 export { createEnvironmentReconciliationPhase } from "./environment-reconciliation.js";
+export { createSubagentReconciliationPhase } from "./subagent-reconciliation.js";
 // ─── Plugin Registry ────────────────────────────────────────
 export { setLoadedPluginNames, PLUGIN_REGISTRY } from "./plugin-registry.js";
 // ─── Handler Utilities ──────────────────────────────────────

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,+DAA+D;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGnE,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oCAAoC,EAAE,MAAM,iCAAiC,CAAC;AAGvF,+DAA+D;AAC/D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG7E,+DAA+D;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,+DAA+D;AAC/D,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,+DAA+D;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGnE,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oCAAoC,EAAE,MAAM,iCAAiC,CAAC;AAEvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAGjF,+DAA+D;AAC/D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG7E,+DAA+D;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,+DAA+D;AAC/D,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/subagent-reconciliation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Subagent reconciliation phase (#1386) — reaps stranded RUNNING subagent
+ * children left behind by #1075.
+ *
+ * A materialized subagent child (`runtime="subagent"`) is only ever closed
+ * through its parent session's event stream. A background/polled child (Copilot
+ * `task` + `read_agent`) whose parent stream ends before a terminal poll lands is
+ * deliberately NOT interrupted by the stream's `finally` block — so it can be
+ * left `RUNNING` forever.
+ *
+ * Once the parent session reaches a terminal state, its stream has ended and the
+ * child can never be updated again (the parent stream is the child's only
+ * mutator), so the child is definitively stranded. This phase interrupts those
+ * children. A merely idle/running parent (still alive) or a SUSPENDED parent
+ * (recoverable — its resumed stream may still legitimately close the child) is
+ * left untouched.
+ *
+ * @module
+ */
+import type { SessionRow } from "@grackle-ai/database";
+import type { ReconciliationPhase } from "@grackle-ai/core";
+/** Dependencies injected into the subagent reconciliation phase for testability. */
+export interface SubagentReconciliationDeps {
+    /** List all materialized subagent child sessions currently in RUNNING. */
+    listRunningSubagentChildren: () => SessionRow[];
+    /** Resolve a session by id (used to look up each child's parent). */
+    getSession: (id: string) => SessionRow | undefined;
+    /** Mark a stranded child interrupted (terminal). Idempotent. */
+    interruptChildSession: (childSessionId: string) => void;
+}
+/**
+ * Create the subagent reconciliation phase.
+ *
+ * @param deps - Injected dependencies for testability.
+ * @returns A ReconciliationPhase that can be registered with the ReconciliationManager.
+ */
+export declare function createSubagentReconciliationPhase(deps: SubagentReconciliationDeps): ReconciliationPhase;
+//# sourceMappingURL=subagent-reconciliation.d.ts.map

package/dist/subagent-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-reconciliation.d.ts","sourceRoot":"","sources":["../src/subagent-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,oFAAoF;AACpF,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,2BAA2B,EAAE,MAAM,UAAU,EAAE,CAAC;IAChD,qEAAqE;IACrE,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IACnD,gEAAgE;IAChE,qBAAqB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,0BAA0B,GAC/B,mBAAmB,CAsCrB"}

package/dist/subagent-reconciliation.js

@@ -0,0 +1,56 @@
+/**
+ * Subagent reconciliation phase (#1386) — reaps stranded RUNNING subagent
+ * children left behind by #1075.
+ *
+ * A materialized subagent child (`runtime="subagent"`) is only ever closed
+ * through its parent session's event stream. A background/polled child (Copilot
+ * `task` + `read_agent`) whose parent stream ends before a terminal poll lands is
+ * deliberately NOT interrupted by the stream's `finally` block — so it can be
+ * left `RUNNING` forever.
+ *
+ * Once the parent session reaches a terminal state, its stream has ended and the
+ * child can never be updated again (the parent stream is the child's only
+ * mutator), so the child is definitively stranded. This phase interrupts those
+ * children. A merely idle/running parent (still alive) or a SUSPENDED parent
+ * (recoverable — its resumed stream may still legitimately close the child) is
+ * left untouched.
+ *
+ * @module
+ */
+import { TERMINAL_SESSION_STATUSES } from "@grackle-ai/common";
+import { logger } from "@grackle-ai/core";
+/**
+ * Create the subagent reconciliation phase.
+ *
+ * @param deps - Injected dependencies for testability.
+ * @returns A ReconciliationPhase that can be registered with the ReconciliationManager.
+ */
+export function createSubagentReconciliationPhase(deps) {
+    return {
+        name: "subagent-reconciliation",
+        execute: async () => {
+            let interrupted = 0;
+            for (const child of deps.listRunningSubagentChildren()) {
+                const parent = child.parentSessionId ? deps.getSession(child.parentSessionId) : undefined;
+                const parentGone = parent === undefined;
+                const parentTerminal = parent !== undefined && TERMINAL_SESSION_STATUSES.has(parent.status);
+                // Leave the child be while the parent is alive (running/idle) or merely
+                // SUSPENDED (recoverable — a resumed stream may still close the child).
+                if (!parentGone && !parentTerminal) {
+                    continue;
+                }
+                try {
+                    deps.interruptChildSession(child.id);
+                    interrupted++;
+                }
+                catch (err) {
+                    logger.error({ err, childId: child.id, parentSessionId: child.parentSessionId }, "Subagent reconciliation: failed to interrupt stranded child");
+                }
+            }
+            if (interrupted > 0) {
+                logger.info({ interrupted }, "Subagent reconciliation: interrupted %d stranded child session(s)", interrupted);
+            }
+        },
+    };
+}
+//# sourceMappingURL=subagent-reconciliation.js.map

package/dist/subagent-reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-reconciliation.js","sourceRoot":"","sources":["../src/subagent-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAa1C;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,WAAW,GAAG,CAAC,CAAC;YAEpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1F,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC;gBACxC,MAAM,cAAc,GAClB,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAuB,CAAC,CAAC;gBAExF,wEAAwE;gBACxE,wEAAwE;gBACxE,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACrC,WAAW,EAAE,CAAC;gBAChB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,EAClE,6DAA6D,CAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CACT,EAAE,WAAW,EAAE,EACf,mEAAmE,EACnE,WAAW,CACZ,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/plugin-core",
-  "version": "0.135.0",
+  "version": "0.135.1",
   "description": "Core plugin for Grackle — gRPC handlers, reconciliation phases, and event subscribers",
   "license": "MIT",
   "repository": {
@@ -33,14 +33,14 @@
     "pino": "^10.3.1",
     "ulid": "^2.3.0",
     "uuid": "^11.1.1",
-    "@grackle-ai/auth": "0.135.0",
-    "@grackle-ai/common": "0.135.0",
-    "@grackle-ai/core": "0.135.0",
-    "@grackle-ai/adapter-sdk": "0.135.0",
-    "@grackle-ai/database": "0.135.0",
-    "@grackle-ai/knowledge": "0.135.0",
-    "@grackle-ai/prompt": "0.135.0",
-    "@grackle-ai/plugin-sdk": "0.135.0"
+    "@grackle-ai/adapter-sdk": "0.135.1",
+    "@grackle-ai/core": "0.135.1",
+    "@grackle-ai/database": "0.135.1",
+    "@grackle-ai/common": "0.135.1",
+    "@grackle-ai/auth": "0.135.1",
+    "@grackle-ai/plugin-sdk": "0.135.1",
+    "@grackle-ai/knowledge": "0.135.1",
+    "@grackle-ai/prompt": "0.135.1"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.7",