@contractspec/lib.surface-runtime 0.2.3 → 0.3.2

package/dist/runtime/overlay-alignment.js

@@ -1,7 +1,5 @@
-// @bun
-// src/runtime/overlay-alignment.ts
 import { applyOverlayModifications } from "@contractspec/lib.overlay-engine/merger";
-function toOverlayScopeContext(ctx) {
+export function toOverlayScopeContext(ctx) {
   return {
     tenantId: ctx.tenantId,
     userId: ctx.actorId,
@@ -9,7 +7,7 @@ function toOverlayScopeContext(ctx) {
     tags: ctx.featureFlags
   };
 }
-function toOverlayTargetRef(_ctx, target) {
+export function toOverlayTargetRef(_ctx, target) {
   return {
     presentation: target.surfaceId ?? target.routeId,
     bundleKey: target.bundleKey,
@@ -18,7 +16,7 @@ function toOverlayTargetRef(_ctx, target) {
     entityType: target.entityType
   };
 }
-function toOverlayAppliesTo(ctx, target, scope) {
+export function toOverlayAppliesTo(ctx, target, scope) {
   const scopeCtx = toOverlayScopeContext(ctx);
   return {
     ...scopeCtx,
@@ -27,7 +25,7 @@ function toOverlayAppliesTo(ctx, target, scope) {
     ...scope === "workspace" && ctx.workspaceId ? { tags: [...scopeCtx.tags ?? [], `workspace:${ctx.workspaceId}`] } : {}
   };
 }
-function toOverlayRenderableField(field) {
+export function toOverlayRenderableField(field) {
   return {
     key: field.fieldId,
     label: field.title,
@@ -36,7 +34,7 @@ function toOverlayRenderableField(field) {
     order: 0
   };
 }
-function fromOverlayRenderableField(overlay) {
+export function fromOverlayRenderableField(overlay) {
   return {
     fieldId: overlay.key,
     title: overlay.label ?? overlay.key,
@@ -44,12 +42,12 @@ function fromOverlayRenderableField(overlay) {
     required: overlay.required ?? false
   };
 }
-function toOverlayRenderable(fields) {
+export function toOverlayRenderable(fields) {
   return {
     fields: fields.map(toOverlayRenderableField)
   };
 }
-function mergeOverlayResultIntoFields(fields, merged) {
+export function mergeOverlayResultIntoFields(fields, merged) {
   const fieldMap = new Map(fields.map((f) => [f.fieldId, { ...f }]));
   const result = [];
   for (const overlay of merged.fields) {
@@ -65,20 +63,10 @@ function mergeOverlayResultIntoFields(fields, merged) {
   }
   return result;
 }
-function applyEntityFieldOverlays(fields, overlays, options) {
+export function applyEntityFieldOverlays(fields, overlays, options) {
   if (!overlays.length)
     return fields;
   const target = toOverlayRenderable(fields);
   const merged = applyOverlayModifications(target, overlays, options);
   return mergeOverlayResultIntoFields(fields, merged);
 }
-export {
-  toOverlayTargetRef,
-  toOverlayScopeContext,
-  toOverlayRenderableField,
-  toOverlayRenderable,
-  toOverlayAppliesTo,
-  mergeOverlayResultIntoFields,
-  fromOverlayRenderableField,
-  applyEntityFieldOverlays
-};

package/dist/runtime/overlay-signer.js

@@ -1,16 +1,10 @@
-// @bun
-// src/runtime/overlay-signer.ts
 import {
   signOverlay,
   verifyOverlaySignature
 } from "@contractspec/lib.overlay-engine/signer";
-function signWorkspaceOverlay(spec, privateKey, options) {
+export function signWorkspaceOverlay(spec, privateKey, options) {
   return signOverlay(spec, privateKey, options);
 }
-function verifyWorkspaceOverlay(overlay) {
+export function verifyWorkspaceOverlay(overlay) {
   return verifyOverlaySignature(overlay);
 }
-export {
-  verifyWorkspaceOverlay,
-  signWorkspaceOverlay
-};

package/dist/runtime/override-store.js

@@ -1,9 +1,7 @@
-// @bun
-// src/runtime/override-store.ts
-function buildOverrideTargetKey(bundleKey, surfaceId, routeId) {
+export function buildOverrideTargetKey(bundleKey, surfaceId, routeId) {
   return routeId ? `${bundleKey}:${routeId}:${surfaceId}` : `${bundleKey}:${surfaceId}`;
 }
-function createOverrideStoreWithApprovalGate(store, options) {
+export function createOverrideStoreWithApprovalGate(store, options) {
   const { requireApprovalForWorkspacePatches = false, requestApproval } = options;
   return {
     list: store.list.bind(store),
@@ -19,7 +17,7 @@ function createOverrideStoreWithApprovalGate(store, options) {
     remove: store.remove.bind(store)
   };
 }
-function createInMemoryOverrideStore() {
+export function createInMemoryOverrideStore() {
   const overrides = new Map;
   function nextId() {
     return `ov_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
@@ -46,8 +44,3 @@ function createInMemoryOverrideStore() {
     }
   };
 }
-export {
-  createOverrideStoreWithApprovalGate,
-  createInMemoryOverrideStore,
-  buildOverrideTargetKey
-};

package/dist/runtime/planner-prompt.js

@@ -1,6 +1,4 @@
-// @bun
-// src/runtime/planner-prompt.ts
-var SAFETY_INSTRUCTIONS = `
+const SAFETY_INSTRUCTIONS = `
 ## Safety instructions (mandatory)
 - Do NOT emit JSX, HTML, or raw markup.
 - Do NOT invent node kinds; use only the allowed kinds listed above.
@@ -8,7 +6,7 @@ var SAFETY_INSTRUCTIONS = `
 - Prefer fewer high-confidence patches over many speculative ones.
 - Explain why a patch helps the user.
 `;
-function compilePlannerPrompt(input) {
+export function compilePlannerPrompt(input) {
   const {
     bundleMeta,
     surfaceId,
@@ -47,7 +45,7 @@ function compilePlannerPrompt(input) {
     parts.push("");
   }
   parts.push("## Current preference profile");
-  parts.push(`guidance=${preferences.guidance}, density=${preferences.density}, ` + `dataDepth=${preferences.dataDepth}, control=${preferences.control}, ` + `media=${preferences.media}, pace=${preferences.pace}, narrative=${preferences.narrative}`);
+  parts.push(`guidance=${preferences.guidance}, density=${preferences.density}, dataDepth=${preferences.dataDepth}, control=${preferences.control}, media=${preferences.media}, pace=${preferences.pace}, narrative=${preferences.narrative}`);
   parts.push("");
   if (planSummary) {
     parts.push("## Current plan summary");
@@ -59,10 +57,14 @@ function compilePlannerPrompt(input) {
     parts.push(`${entity.type}: ${entity.id}`);
     parts.push("");
   }
-  parts.push(SAFETY_INSTRUCTIONS.trim());
+  parts.push(`
+## Safety instructions (mandatory)
+- Do NOT emit JSX, HTML, or raw markup.
+- Do NOT invent node kinds; use only the allowed kinds listed above.
+- Do NOT call undeclared tools.
+- Prefer fewer high-confidence patches over many speculative ones.
+- Explain why a patch helps the user.
+`.trim());
   return parts.join(`
 `);
 }
-export {
-  compilePlannerPrompt
-};

package/dist/runtime/planner-tools.js

@@ -1,6 +1,4 @@
-// @bun
-// src/runtime/planner-tools.ts
-var PROPOSE_PATCH_TOOL_SCHEMA = {
+export const PROPOSE_PATCH_TOOL_SCHEMA = {
   type: "object",
   properties: {
     proposalId: { type: "string", description: "Unique proposal identifier" },
@@ -56,14 +54,14 @@ var PROPOSE_PATCH_TOOL_SCHEMA = {
   },
   required: ["proposalId", "ops"]
 };
-var proposePatchToolConfig = {
+export const proposePatchToolConfig = {
   name: "propose-patch",
-  description: "Propose surface patches (layout changes, node insertions, etc.) for user approval. " + "Only use allowed ops, slots, and node kinds from the planner context.",
+  description: "Propose surface patches (layout changes, node insertions, etc.) for user approval. Only use allowed ops, slots, and node kinds from the planner context.",
   schema: PROPOSE_PATCH_TOOL_SCHEMA,
   automationSafe: false,
   requiresApproval: true
 };
-function buildSurfacePatchProposal(proposalId, ops) {
+export function buildSurfacePatchProposal(proposalId, ops) {
   return {
     proposalId,
     source: "assistant",
@@ -71,8 +69,3 @@ function buildSurfacePatchProposal(proposalId, ops) {
     approvalState: "proposed"
   };
 }
-export {
-  proposePatchToolConfig,
-  buildSurfacePatchProposal,
-  PROPOSE_PATCH_TOOL_SCHEMA
-};

package/dist/runtime/policy-eval.js

@@ -1,140 +1,11 @@
-// @bun
-// src/runtime/audit-events.ts
-function generateEventId() {
-  return `evt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function emitPatchProposed(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: args.proposal.source === "assistant" ? "assistant" : "user",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "patch.proposed",
-    payload: {
-      proposalId: args.proposal.proposalId,
-      source: args.proposal.source,
-      opsCount: args.proposal.ops.length
-    }
-  });
-}
-function emitPatchApproved(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: "user",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "patch.approved",
-    payload: {
-      proposalId: args.proposalId,
-      source: args.source,
-      opsCount: args.opsCount,
-      reason: args.reason
-    }
-  });
-}
-function emitPatchRejected(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: "user",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "patch.rejected",
-    payload: {
-      proposalId: args.proposalId,
-      source: args.source,
-      opsCount: args.opsCount,
-      reason: args.reason
-    }
-  });
-}
-function emitOverlaySaved(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: "user",
-    bundleKey: args.bundleKey,
-    eventType: "overlay.saved",
-    payload: {
-      overlayId: args.overlayId,
-      scope: args.scope,
-      opsCount: args.opsCount
-    }
-  });
-}
-function emitOverlayApplied(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    source: "system",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "overlay.applied",
-    payload: {
-      overlayId: args.overlayId,
-      opsCount: args.opsCount
-    }
-  });
-}
-function emitOverlayFailed(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    source: "system",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "overlay.failed",
-    payload: {
-      overlayId: args.overlayId,
-      error: args.error
-    }
-  });
-}
-function emitPolicyDenied(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: "policy",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "policy.denied",
-    payload: {
-      targetId: args.targetId,
-      reason: args.reason
-    }
-  });
-}
-function emitPolicyRedacted(audit, args) {
-  audit.emit({
-    eventId: generateEventId(),
-    at: new Date().toISOString(),
-    actorId: args.actorId,
-    source: "policy",
-    bundleKey: args.bundleKey,
-    surfaceId: args.surfaceId,
-    eventType: "policy.redacted",
-    payload: {
-      targetId: args.targetId,
-      redactions: args.redactions
-    }
-  });
-}
-
-// src/runtime/policy-eval.ts
-function evaluatePatchProposalPolicy(ops, ctx, policy) {
+import { emitPolicyDenied } from "./audit-events";
+export function evaluatePatchProposalPolicy(ops, ctx, policy) {
   const evaluate = policy?.evaluatePatchProposal;
   if (!evaluate)
     return "allow";
   return evaluate(ops, ctx);
 }
-function evaluateAndEmitPatchPolicy(ops, ctx, args) {
+export function evaluateAndEmitPatchPolicy(ops, ctx, args) {
   const effect = evaluatePatchProposalPolicy(ops, ctx, args.policy);
   if (effect === "deny") {
     if (args.audit) {
@@ -150,7 +21,3 @@ function evaluateAndEmitPatchPolicy(ops, ctx, args) {
   }
   return true;
 }
-export {
-  evaluatePatchProposalPolicy,
-  evaluateAndEmitPatchPolicy
-};

package/dist/runtime/preference-adapter.js

@@ -1,68 +1,7 @@
-// @bun
-// src/runtime/resolve-preferences.ts
-var DIMENSION_KEYS = [
-  "guidance",
-  "density",
-  "dataDepth",
-  "control",
-  "media",
-  "pace",
-  "narrative"
-];
-var SCOPE_ORDER = [
-  "user",
-  "workspace-user",
-  "bundle",
-  "surface",
-  "entity",
-  "session"
-];
-function mergeByScope(layers, ctx) {
-  const merged = { ...ctx.preferences };
-  const sourceByDimension = {};
-  for (const scope of SCOPE_ORDER) {
-    const layer = layers[scope];
-    if (!layer)
-      continue;
-    for (const dim of DIMENSION_KEYS) {
-      const val = layer[dim];
-      if (val !== undefined) {
-        merged[dim] = val;
-        sourceByDimension[dim] = scope;
-      }
-    }
-  }
-  for (const dim of DIMENSION_KEYS) {
-    if (sourceByDimension[dim] === undefined) {
-      sourceByDimension[dim] = "session";
-    }
-  }
-  return { canonical: merged, sourceByDimension };
-}
-function resolveConstraints(_canonical, _ctx) {
-  return { constrained: {}, notes: [] };
-}
-function resolvePreferenceProfile(ctx) {
-  const layers = {
-    session: ctx.preferences
-  };
-  const { canonical, sourceByDimension } = mergeByScope(layers, ctx);
-  const { constrained, notes } = resolveConstraints(canonical, ctx);
-  return {
-    canonical,
-    sourceByDimension,
-    constrained,
-    notes
-  };
-}
-
-// src/runtime/preference-adapter.ts
-var defaultPreferenceAdapter = {
+import { resolvePreferenceProfile } from "./resolve-preferences";
+export const defaultPreferenceAdapter = {
   async resolve(ctx) {
     return resolvePreferenceProfile(ctx);
   },
   async savePreferencePatch(_args) {}
 };
-export {
-  defaultPreferenceAdapter
-};