genesis-compiler 1.7.7 → 1.7.8

package/docs/prompt-integration.md

@@ -82,7 +82,25 @@ JSON on stdin:
 ```
 
 For `genesis hook turn`, the input has the same shape with `scope: "turn"`.
-The executable returns only the requested host contribution as text. Codex and Claude Code
+The executable returns exactly one JSON result:
+
+- `{"kind":"unclaimed"}`: this native conversation is not managed by the host;
+  Genesis delivers its standalone guide.
+- `{"kind":"contribution","text":"..."}`: Genesis composes this bounded host
+  contribution with its own session guide (or bounded turn contribution).
+- `{"kind":"delivery","text":"..."}`: the host owns the complete session
+  delivery; Genesis forwards it without adding its standalone copy. Empty text
+  means the host already delivers through a native system field. This result
+  is valid only for session scope.
+
+Malformed results and configured-resolver failures fail the hook. An unavailable
+claimed owner must fail rather than returning `unclaimed`. Ownership belongs to
+the native conversation: these results do not change project hook files, so
+independent CLI and managed conversations can use the same project. The host
+owns durable bindings, ancestry verification and restoration across reconnection.
+No host framework dependency is added to Genesis.
+
+Codex and Claude Code
 hook input and OpenCode's transform callbacks supply the native session id;
 Genesis extracts that id but does not understand the host registry or the
 provider's prompt-placement rules. The Codex and Claude prompt hooks and OpenCode message
@@ -104,8 +122,8 @@ Codex hook settings. A host can render these fields as an actionable failure
 instead of displaying the runtime stack.
 
 The OpenCode session adapter also includes verified native `parentSessionIds`
-in `GENESIS_HOST_CONTEXT_INPUT` for host command shims. The resolver still
-receives the actual child's `providerSessionId`; Genesis does not interpret a
+in `GENESIS_HOST_CONTEXT_INPUT` for host command shims and in the resolver
+request when present (at most 32 IDs). The resolver receives the actual child's `providerSessionId`; Genesis does not interpret a
 host's ownership rules.
 
 After updating Genesis, hosts can inspect all generated integrations with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "type": "module",
   "description": "An agent-independent prompt, multi-language code-index, cleanup, and verification companion with project agent guidance.",
   "repository": {

package/src/cli.js

@@ -426,8 +426,8 @@ function writeResult(command, result) {
   line(process.stdout, `${command}: ${result.status}`);
 }
 
-async function hookSessionId(environment = process.env) {
-  if (!environment[HOST_CONTEXT_RESOLVER_ENV]) return null;
+async function hookSessionInput(environment = process.env) {
+  if (!environment[HOST_CONTEXT_RESOLVER_ENV]) return {};
   let source = environment[HOST_CONTEXT_INPUT_ENV];
   if (source === undefined && !process.stdin.isTTY) {
     const chunks = [];
@@ -441,7 +441,7 @@ async function hookSessionId(environment = process.env) {
     }
     source = Buffer.concat(chunks).toString('utf8');
   }
-  if (!String(source || '').trim()) return null;
+  if (!String(source || '').trim()) return {};
   let input;
   try {
     input = JSON.parse(source);
@@ -449,7 +449,15 @@ async function hookSessionId(environment = process.env) {
     fail('HOST_CONTEXT_INPUT_INVALID', 'The host hook input must contain JSON.');
   }
   const sessionId = input?.sessionId ?? input?.session_id;
-  return typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : null;
+  const parentSessionIds = input?.parentSessionIds ?? [];
+  if (!Array.isArray(parentSessionIds) || parentSessionIds.length > 32 ||
+      parentSessionIds.some(id => typeof id !== 'string' || !id.trim())) {
+    fail('HOST_CONTEXT_INPUT_INVALID', 'Native parent session ids must be a bounded list of strings.');
+  }
+  return {
+    providerSessionId: typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : null,
+    ...(parentSessionIds.length ? { parentSessionIds } : {}),
+  };
 }
 
 async function cliStackPackages(projectRoot, supplied) {
@@ -574,19 +582,24 @@ async function execute({ command, operands, options }, { signal } = {}) {
     if (scope === 'session' && process.env[SESSION_CONTEXT_INSTALLED_ENV] === '1') {
       return { kind: 'session', status: 'ready', output: '' };
     }
-    const providerSessionId = await hookSessionId();
+    const nativeSession = await hookSessionInput();
     const hostContext = await resolveConfiguredHostContext({
       projectRoot,
-      providerSessionId,
+      ...nativeSession,
       scope,
     });
+    // Ownership is resolved for this native conversation, not for the project.
+    // A host-owned delivery already contains everything its runtime requires.
+    if (hostContext?.kind === 'delivery') {
+      return { kind: 'session', status: 'ready', output: hostContext.text };
+    }
     if (scope === 'turn') {
       return hostContext === null
         ? { kind: 'turn', status: 'ready', output: '' }
         : {
             kind: 'turn',
             ...await projectTurnContext({
-              hostDriver: () => hostContext,
+              hostDriver: () => hostContext.text,
               hostDriverInput: { scope: 'turn' },
             }),
           };
@@ -595,7 +608,7 @@ async function execute({ command, operands, options }, { signal } = {}) {
       kind: 'session',
       ...await projectSessionContext({
         ...(hostContext === null ? {} : {
-          hostDriver: () => hostContext,
+          hostDriver: () => hostContext.text,
           hostDriverInput: { scope: 'session' },
         }),
         projectRoot,

package/src/index/host-context-resolver.js

@@ -55,6 +55,7 @@ export async function resolveConfiguredHostContext({
   environment = process.env,
   projectRoot,
   providerSessionId = null,
+  parentSessionIds = [],
   scope = 'session',
 } = {}) {
   const command = configuredResolver(environment);
@@ -66,8 +67,20 @@ export async function resolveConfiguredHostContext({
     input: {
       scope,
       providerSessionId: providerSessionId || null,
+      ...(parentSessionIds.length ? { parentSessionIds } : {}),
       data: resolverData(environment),
     },
   });
-  return output;
+  let result;
+  try { result = JSON.parse(output); } catch {
+    throw resolverError('The host context resolver must return a JSON delivery result.');
+  }
+  if (!result || typeof result !== 'object' || Array.isArray(result) ||
+      !['unclaimed', 'contribution', 'delivery'].includes(result.kind) ||
+      Object.keys(result).some((key) => !['kind', 'text'].includes(key)) ||
+      (result.kind === 'unclaimed' ? Object.hasOwn(result, 'text') : typeof result.text !== 'string') ||
+      (result.kind === 'delivery' && scope !== 'session')) {
+    throw resolverError('Invalid host context delivery result.');
+  }
+  return result.kind === 'unclaimed' ? null : result;
 }