Add interface-oriented client sessions and headless capability access (WI-07)

src/execution-world/client-contracts.ts

@@ -112,7 +112,7 @@ export function generateInterfaceClientBindings(
         .filter((op) => op.mode === "call")
         .map(
           (op) =>
-            `${JSON.stringify(op.displayName)}: defineInterfaceOperation<${tsType(op.inputType)}, ${tsType(op.outputType)}>(${JSON.stringify(publicOperationContract(iface, op))})`,
+            `${JSON.stringify(op.displayName)}: defineInterfaceOperation<${tsType(op.inputType)}, ${tsType(op.outputType)}, ${JSON.stringify(publicOperationContract(iface, op).execution)}>(${JSON.stringify(publicOperationContract(iface, op))})`,
         );
       return `${JSON.stringify(member.displayName)}: {${operations.join(",\n")}}`;
     });
@@ -120,3 +120,14 @@ export function generateInterfaceClientBindings(
   });
   return `// Generated from imported interface contracts. Regenerate; do not edit.\nimport { defineInterfaceOperation, type PreparedChange, type ManagedReference } from ${JSON.stringify(runtimeModule)};\nexport const interfaces = {${entries.join(",\n")}} as const;\n`;
 }
+
+export function generatePackageQueryClientBindings(
+  pkg: PackageRevision,
+  runtimeModule = "@quixos/camino-replica-core",
+): string {
+  const queries = (pkg.checkedQueries ?? []).map(
+    (query) =>
+      `${JSON.stringify(query.declaration.displayName)}: definePackageQuery<${tsType(query.variables)}, ${tsType(query.output)}>(${JSON.stringify(publicQueryContract(pkg, query.declaration.id))})`,
+  );
+  return `// Generated from checked package query contracts. Regenerate; do not edit.\nimport { definePackageQuery, type ManagedReference } from ${JSON.stringify(runtimeModule)};\nexport const queries = {${queries.join(",\n")}} as const;\n`;
+}

src/execution-world/installation.ts

@@ -9,6 +9,7 @@ import {
   type PublicOperationContract,
   type PublicQueryContract,
 } from "./client-contracts.js";
+import { resultInterfaces } from "./projections.js";
 
 /** Activation is assigned by graph authority, never by a package artifact. */
 export interface ActiveExecutionIdentity {
@@ -23,6 +24,7 @@ export interface ExecutionGroupIdentity {
   readonly executionDigest: string;
 }
 export interface ClientContractCatalog {
+  readonly resultInterfaces: Readonly<Record<string, readonly string[]>>;
   readonly operations: readonly PublicOperationContract[];
   readonly queries: readonly PublicQueryContract[];
   readonly components: readonly InstalledComponent[];
@@ -58,6 +60,9 @@ export function clientContractCatalog(
       ),
     );
   return {
+    resultInterfaces: Object.fromEntries(
+      plan.definition.operations.map((operation) => [operation.key, resultInterfaces(plan, operation.key)]),
+    ),
     operations,
     queries: packages.flatMap((pkg) =>
       (pkg.checkedQueries ?? []).map((q) => publicQueryContract(pkg, q.declaration.id)),