@synap-core/workspace-templates 0.11.0 → 0.23.0

package/dist/wire.d.ts

@@ -0,0 +1,222 @@
+import { g as PackageDefinitionOutput, X as WorkspaceDefinitionInput } from './define-CPS0n8BV.js';
+import '@synap-core/types/presentation';
+import '@synap-core/types/space-brief';
+import '@synap-core/types/capability-intents';
+
+/**
+ * The per-kind wire envelopes and the ONE unwrap — import-free on purpose.
+ *
+ * Re-exported (with the workspace types) by `./wire`, the public subpath
+ * `@synap-core/workspace-templates/wire`. It has no imports so a consumer that
+ * still resolves an older npm copy of this package (the CLI, the CP, the pod)
+ * can carry it as a BYTE-IDENTICAL mirror pinned by a tripwire until it can
+ * import the subpath. Edit it here; the mirror copies it.
+ *
+ * What `GET {CP}/api/packages/:slug` serves as `package.definition`, per kind:
+ * the outputs of this package's producers (`scripts/catalog-lib.mjs`
+ * `toPublishBody`; `toOfficialPublishBody` for workspaces) plus what the CP
+ * adds on store/serve (`_meta.slug` via `withTemplateSlug`,
+ * `capability.contentHash`).
+ *
+ * WHY: a skill package is served as `{ _meta, skill: {…} }`. Read flat, every
+ * field is `undefined`: install refused a "bodiless" skill and the update door
+ * reported "no drift" forever (founder pod 2026-10-13, creative-director). Each
+ * consumer had its own cast; this is the one place the envelope is known.
+ *
+ * Element fields are pinned to the catalog schema (`SKILL_FIELDS`,
+ * `CapabilitySpec`) and `AutomationElement` to `PackageAutomationWire` by
+ * `schema/wire.parity.test.ts` (compile time).
+ */
+/** The kinds whose served definition this module describes. */
+declare const WIRE_KINDS: readonly ["workspace", "capability", "skill", "automation", "view"];
+type WireKind = (typeof WIRE_KINDS)[number];
+/**
+ * Other names the same kinds go by: the pod's `market.install` says
+ * `template`, the CP category for an automation is `workflow`, and a pack is
+ * a workspace-shaped definition.
+ */
+declare const WIRE_KIND_ALIASES: {
+    readonly template: "workspace";
+    readonly pack: "workspace";
+    readonly workflow: "automation";
+};
+type WireKindName = WireKind | keyof typeof WIRE_KIND_ALIASES;
+/** `template` → `workspace`, `workflow` → `automation`; `null` for a kind with no wire contract here (e.g. `cell`). */
+declare function toWireKind(kind: string): WireKind | null;
+/**
+ * `definition._meta` as served: the CP stamps `slug` on every row (the pod
+ * keys "which space is this template's?" on it); the CLI adds the `version`
+ * label it installs.
+ */
+interface WireMeta {
+    slug?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/** `meta.icon` / `color` / `domain`, mirrored onto the definition by every publish builder. */
+interface WireIdentity {
+    icon?: string;
+    color?: string;
+    domain?: string;
+}
+/** A composition dependency. */
+interface WireDependency {
+    slug: string;
+    kind?: "workspace" | "capability" | "skill" | "workflow" | "view" | "cell" | "automation";
+    relation?: "compose" | "require";
+    reason?: string;
+}
+interface WireEnvelope extends WireIdentity {
+    _meta?: WireMeta;
+    dependencies?: WireDependency[];
+}
+/** The capability itself (`CapabilityDefinition`). */
+interface CapabilityElement {
+    key: string;
+    name: string;
+    description?: string;
+    params?: Array<Record<string, unknown>>;
+    vault?: Array<Record<string, unknown>>;
+    tools?: Array<Record<string, unknown>>;
+    skills?: Array<Record<string, unknown>>;
+    provides?: string[];
+    playbooks?: Array<Record<string, unknown>>;
+    /** Stamped by the CP on publish; the pod's drift marker. */
+    contentHash?: string;
+    automations?: Array<Record<string, unknown>>;
+    mcpServers?: unknown;
+    metadata?: Record<string, unknown>;
+    _generated?: unknown;
+}
+/** capability: `{ profiles: [], description, capability }`. */
+interface CapabilityWire extends WireEnvelope {
+    profiles: unknown[];
+    description?: string;
+    capability: CapabilityElement;
+}
+/** ONE standalone skill. Not a workspace's `skills[]` link list. */
+interface SkillElement {
+    /** The pod-side `load_skill` ref — its own identity, not the package slug. */
+    slug?: string;
+    name?: string;
+    displayName?: string;
+    description?: string;
+    kind?: "instruction" | "code" | "declarative" | "builtin";
+    scope?: "pod" | "user" | "workspace";
+    agentTypes?: string[];
+    body?: string;
+    code?: string;
+    providerSpec?: Record<string, unknown>;
+    parameters?: Record<string, unknown>;
+    category?: string;
+    executionMode?: "sync" | "async";
+    timeoutSeconds?: number;
+    intent?: string;
+    [key: string]: unknown;
+}
+/** skill: `{ skill, icon?, color?, domain?, dependencies? }`. */
+interface SkillWire extends WireEnvelope {
+    skill: SkillElement;
+}
+/** One graph automation (= `PackageAutomationWire`): `flowDefinition`, not the authored `flow`. */
+interface AutomationElement {
+    key?: string;
+    name: string;
+    description?: string;
+    triggerType: "event" | "cron" | "webhook" | "manual";
+    triggerConfig?: Record<string, unknown>;
+    flowDefinition?: {
+        nodes: unknown[];
+        edges: unknown[];
+        precondition?: string;
+    };
+    status?: "draft" | "active" | "paused";
+}
+/** automation (CP category `workflow`): `{ profiles: [], automations: [one] }`. */
+interface AutomationWire extends WireEnvelope {
+    profiles: unknown[];
+    automations: AutomationElement[];
+}
+/** One view, as the pod's view install and update doors read it. */
+interface ViewElement {
+    slug?: string;
+    name?: string;
+    displayName?: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    scopeProfileSlugs?: string[];
+    scopeProfileIds?: string[];
+    [key: string]: unknown;
+}
+/** view: `{ views: [...] }`, or a legacy single view with its fields on top (has its own `type`). No catalog producer today. */
+type ViewWire = (WireEnvelope & {
+    views: ViewElement[];
+}) | ViewElement;
+/**
+ * What {@link unwrapPackage} returns per kind. `workspace` is the definition
+ * itself; `./wire` narrows it to `WorkspaceWire`.
+ */
+interface PackageElementByKind<W = Record<string, unknown>> {
+    workspace: W;
+    capability: CapabilityElement;
+    skill: SkillElement;
+    automation: AutomationElement[];
+    view: ViewElement[];
+}
+type ElementOf<K extends WireKindName, W = Record<string, unknown>> = PackageElementByKind<W>[K extends WireKind ? K : K extends keyof typeof WIRE_KIND_ALIASES ? (typeof WIRE_KIND_ALIASES)[K] : never];
+
+/**
+ * @synap-core/workspace-templates/wire — ONE wire contract per package kind.
+ *
+ * The per-kind envelopes and `unwrapPackage` live in `./wire-core` (import-free,
+ * so it can be mirrored byte-for-byte by consumers still pinned to an older npm
+ * copy). This adds what needs the rest of the package: the workspace envelope,
+ * derived from `PackageDefinitionOutput` instead of re-declared, and the one
+ * workspace wire → create-input translation.
+ */
+
+/**
+ * workspace / pack: `toPackageDefinition()` output — re-used, not re-declared.
+ * As served it is `toOfficialPublishBody().definition` (identity mirrored on
+ * top, `sourcePackage`) with `_meta` cut down to what the CP stamps; a bundled
+ * `PackageDefinitionOutput` is assignable to it as is.
+ */
+type WorkspaceWire = Omit<PackageDefinitionOutput, "_meta"> & WireIdentity & {
+    _meta?: Partial<PackageDefinitionOutput["_meta"]> & WireMeta;
+    /** Which build of this package generated the row (official rows only). */
+    sourcePackage?: {
+        name: string;
+        version: string;
+    };
+};
+/** The served definition, keyed by kind. */
+interface PackageWireByKind {
+    workspace: WorkspaceWire;
+    capability: CapabilityWire;
+    skill: SkillWire;
+    automation: AutomationWire;
+    view: ViewWire;
+}
+type PackageWire = PackageWireByKind[WireKind];
+/** `./wire-core`'s `unwrapPackage`, with the workspace element typed as {@link WorkspaceWire}. */
+declare function unwrapPackage<K extends WireKindName>(kind: K, definition: unknown): ElementOf<K, WorkspaceWire>;
+/**
+ * The served workspace definition → the input the pod's create/reconcile door
+ * takes (`WorkspaceDefinitionInput`). The two renames live here and only here:
+ * `suggestedEntities` → `seedEntities` and `automations` (graph flows) →
+ * `flowAutomations`.
+ *
+ * A 1:1 copy of the pod's `toWorkspaceDefinitionInput`
+ * (synap-backend `services/capabilities/resolve-workspace-template.ts`), so the
+ * pod can import this instead. Like it, it does NOT carry `taskIntents`,
+ * `capabilities`, `playbooks`, `actionPlacements`, `rules` or `skills`: the
+ * post-workspace layer reads the last five off the package definition itself;
+ * `taskIntents` is a gap on that path today. `wire.test.ts` pins every
+ * difference from `toWorkspaceDefinition`.
+ */
+declare function toWorkspaceInput(pkg: WorkspaceWire): WorkspaceDefinitionInput;
+
+export { type AutomationElement, type AutomationWire, type CapabilityElement, type CapabilityWire, type PackageElementByKind, type PackageWire, type PackageWireByKind, type SkillElement, type SkillWire, type ViewElement, type ViewWire, WIRE_KINDS, WIRE_KIND_ALIASES, type WireDependency, type WireEnvelope, type WireIdentity, type WireKind, type WireKindName, type WireMeta, type WorkspaceWire, toWireKind, toWorkspaceInput, unwrapPackage };

package/dist/wire.js

@@ -0,0 +1,77 @@
+// src/wire-core.ts
+var WIRE_KINDS = ["workspace", "capability", "skill", "automation", "view"];
+var WIRE_KIND_ALIASES = {
+  template: "workspace",
+  pack: "workspace",
+  workflow: "automation"
+};
+function toWireKind(kind) {
+  if (WIRE_KINDS.includes(kind)) return kind;
+  return WIRE_KIND_ALIASES[kind] ?? null;
+}
+var isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function unwrapPackage(kind, definition) {
+  const wireKind = toWireKind(kind);
+  if (!wireKind) throw new Error(`unwrapPackage: "${kind}" has no wire contract`);
+  if (!isRecord(definition)) {
+    throw new TypeError(
+      `unwrapPackage(${kind}): the definition is not an object (${definition === null ? "null" : Array.isArray(definition) ? "array" : typeof definition})`
+    );
+  }
+  switch (wireKind) {
+    case "skill":
+      return isRecord(definition.skill) ? definition.skill : definition;
+    case "capability":
+      return isRecord(definition.capability) ? definition.capability : definition;
+    case "automation":
+      return Array.isArray(definition.automations) ? definition.automations : [];
+    case "view":
+      if (Array.isArray(definition.views) && definition.views.length > 0) return definition.views;
+      return definition.type ? [definition] : [];
+    case "workspace":
+      return definition;
+  }
+}
+
+// src/wire.ts
+function unwrapPackage2(kind, definition) {
+  return unwrapPackage(kind, definition);
+}
+function toWorkspaceInput(pkg) {
+  return {
+    workspaceName: pkg.workspaceName,
+    description: pkg.description,
+    proposalId: pkg._meta?.slug,
+    profiles: pkg.profiles,
+    views: pkg.views ?? [],
+    entityLinks: pkg.entityLinks ?? [],
+    seedEntities: pkg.suggestedEntities ?? [],
+    suggestedRelations: pkg.suggestedRelations,
+    displayTemplates: pkg.displayTemplates,
+    layoutConfig: pkg.layoutConfig,
+    bentoViewName: pkg.bentoViewName,
+    bentoLayout: pkg.bentoLayout,
+    bentoViewBlocks: pkg.bentoViewBlocks,
+    profileEntityBentoTemplates: pkg.profileEntityBentoTemplates,
+    workspaceSubtype: pkg.workspaceSubtype,
+    workspaceType: pkg.workspaceType,
+    workspaceVisibility: pkg.workspaceVisibility,
+    workspaceCapabilities: pkg.workspaceCapabilities,
+    intent: pkg.intent,
+    sourceRoles: pkg.sourceRoles,
+    defaultSources: pkg.defaultSources,
+    onboarding: pkg.onboarding,
+    dependencies: pkg.dependencies,
+    flowAutomations: pkg.automations ?? [],
+    commands: pkg.commands ?? [],
+    relationDefs: pkg.relationDefs ?? []
+  };
+}
+export {
+  WIRE_KINDS,
+  WIRE_KIND_ALIASES,
+  toWireKind,
+  toWorkspaceInput,
+  unwrapPackage2 as unwrapPackage
+};
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wire-core.ts","../src/wire.ts"],"sourcesContent":["/**\n * The per-kind wire envelopes and the ONE unwrap — import-free on purpose.\n *\n * Re-exported (with the workspace types) by `./wire`, the public subpath\n * `@synap-core/workspace-templates/wire`. It has no imports so a consumer that\n * still resolves an older npm copy of this package (the CLI, the CP, the pod)\n * can carry it as a BYTE-IDENTICAL mirror pinned by a tripwire until it can\n * import the subpath. Edit it here; the mirror copies it.\n *\n * What `GET {CP}/api/packages/:slug` serves as `package.definition`, per kind:\n * the outputs of this package's producers (`scripts/catalog-lib.mjs`\n * `toPublishBody`; `toOfficialPublishBody` for workspaces) plus what the CP\n * adds on store/serve (`_meta.slug` via `withTemplateSlug`,\n * `capability.contentHash`).\n *\n * WHY: a skill package is served as `{ _meta, skill: {…} }`. Read flat, every\n * field is `undefined`: install refused a \"bodiless\" skill and the update door\n * reported \"no drift\" forever (founder pod 2026-10-13, creative-director). Each\n * consumer had its own cast; this is the one place the envelope is known.\n *\n * Element fields are pinned to the catalog schema (`SKILL_FIELDS`,\n * `CapabilitySpec`) and `AutomationElement` to `PackageAutomationWire` by\n * `schema/wire.parity.test.ts` (compile time).\n */\n\n// ─── Kinds ──────────────────────────────────────────────────────────────────\n\n/** The kinds whose served definition this module describes. */\nexport const WIRE_KINDS = [\"workspace\", \"capability\", \"skill\", \"automation\", \"view\"] as const;\nexport type WireKind = (typeof WIRE_KINDS)[number];\n\n/**\n * Other names the same kinds go by: the pod's `market.install` says\n * `template`, the CP category for an automation is `workflow`, and a pack is\n * a workspace-shaped definition.\n */\nexport const WIRE_KIND_ALIASES = {\n  template: \"workspace\",\n  pack: \"workspace\",\n  workflow: \"automation\",\n} as const satisfies Record<string, WireKind>;\nexport type WireKindName = WireKind | keyof typeof WIRE_KIND_ALIASES;\n\n/** `template` → `workspace`, `workflow` → `automation`; `null` for a kind with no wire contract here (e.g. `cell`). */\nexport function toWireKind(kind: string): WireKind | null {\n  if ((WIRE_KINDS as readonly string[]).includes(kind)) return kind as WireKind;\n  return (WIRE_KIND_ALIASES as Record<string, WireKind>)[kind] ?? null;\n}\n\n// ─── Envelope pieces every kind shares ──────────────────────────────────────\n\n/**\n * `definition._meta` as served: the CP stamps `slug` on every row (the pod\n * keys \"which space is this template's?\" on it); the CLI adds the `version`\n * label it installs.\n */\nexport interface WireMeta {\n  slug?: string;\n  version?: string;\n  [key: string]: unknown;\n}\n\n/** `meta.icon` / `color` / `domain`, mirrored onto the definition by every publish builder. */\nexport interface WireIdentity {\n  icon?: string;\n  color?: string;\n  domain?: string;\n}\n\n/** A composition dependency. */\nexport interface WireDependency {\n  slug: string;\n  kind?: \"workspace\" | \"capability\" | \"skill\" | \"workflow\" | \"view\" | \"cell\" | \"automation\";\n  relation?: \"compose\" | \"require\";\n  reason?: string;\n}\n\nexport interface WireEnvelope extends WireIdentity {\n  _meta?: WireMeta;\n  dependencies?: WireDependency[];\n}\n\n// ─── Elements and envelopes, per kind ───────────────────────────────────────\n\n/** The capability itself (`CapabilityDefinition`). */\nexport interface CapabilityElement {\n  key: string;\n  name: string;\n  description?: string;\n  params?: Array<Record<string, unknown>>;\n  vault?: Array<Record<string, unknown>>;\n  tools?: Array<Record<string, unknown>>;\n  skills?: Array<Record<string, unknown>>;\n  provides?: string[];\n  playbooks?: Array<Record<string, unknown>>;\n  /** Stamped by the CP on publish; the pod's drift marker. */\n  contentHash?: string;\n  automations?: Array<Record<string, unknown>>;\n  mcpServers?: unknown;\n  metadata?: Record<string, unknown>;\n  _generated?: unknown;\n}\n\n/** capability: `{ profiles: [], description, capability }`. */\nexport interface CapabilityWire extends WireEnvelope {\n  profiles: unknown[];\n  description?: string;\n  capability: CapabilityElement;\n}\n\n/** ONE standalone skill. Not a workspace's `skills[]` link list. */\nexport interface SkillElement {\n  /** The pod-side `load_skill` ref — its own identity, not the package slug. */\n  slug?: string;\n  name?: string;\n  displayName?: string;\n  description?: string;\n  kind?: \"instruction\" | \"code\" | \"declarative\" | \"builtin\";\n  scope?: \"pod\" | \"user\" | \"workspace\";\n  agentTypes?: string[];\n  body?: string;\n  code?: string;\n  providerSpec?: Record<string, unknown>;\n  parameters?: Record<string, unknown>;\n  category?: string;\n  executionMode?: \"sync\" | \"async\";\n  timeoutSeconds?: number;\n  intent?: string;\n  [key: string]: unknown;\n}\n\n/** skill: `{ skill, icon?, color?, domain?, dependencies? }`. */\nexport interface SkillWire extends WireEnvelope {\n  skill: SkillElement;\n}\n\n/** One graph automation (= `PackageAutomationWire`): `flowDefinition`, not the authored `flow`. */\nexport interface AutomationElement {\n  key?: string;\n  name: string;\n  description?: string;\n  triggerType: \"event\" | \"cron\" | \"webhook\" | \"manual\";\n  triggerConfig?: Record<string, unknown>;\n  flowDefinition?: { nodes: unknown[]; edges: unknown[]; precondition?: string };\n  status?: \"draft\" | \"active\" | \"paused\";\n}\n\n/** automation (CP category `workflow`): `{ profiles: [], automations: [one] }`. */\nexport interface AutomationWire extends WireEnvelope {\n  profiles: unknown[];\n  automations: AutomationElement[];\n}\n\n/** One view, as the pod's view install and update doors read it. */\nexport interface ViewElement {\n  slug?: string;\n  name?: string;\n  displayName?: string;\n  description?: string;\n  type?: string;\n  config?: Record<string, unknown>;\n  query?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n  scopeProfileSlugs?: string[];\n  scopeProfileIds?: string[];\n  [key: string]: unknown;\n}\n\n/** view: `{ views: [...] }`, or a legacy single view with its fields on top (has its own `type`). No catalog producer today. */\nexport type ViewWire = (WireEnvelope & { views: ViewElement[] }) | ViewElement;\n\n/**\n * What {@link unwrapPackage} returns per kind. `workspace` is the definition\n * itself; `./wire` narrows it to `WorkspaceWire`.\n */\nexport interface PackageElementByKind<W = Record<string, unknown>> {\n  workspace: W;\n  capability: CapabilityElement;\n  skill: SkillElement;\n  automation: AutomationElement[];\n  view: ViewElement[];\n}\n\nexport type ElementOf<K extends WireKindName, W = Record<string, unknown>> = PackageElementByKind<W>[K extends WireKind\n  ? K\n  : K extends keyof typeof WIRE_KIND_ALIASES\n    ? (typeof WIRE_KIND_ALIASES)[K]\n    : never];\n\n// ─── The ONE unwrap ─────────────────────────────────────────────────────────\n\nconst isRecord = (v: unknown): v is Record<string, unknown> =>\n  typeof v === \"object\" && v !== null && !Array.isArray(v);\n\n/**\n * The installable element(s) inside a served definition:\n *\n *   skill      → the `skill` object (a legacy flat definition is the skill itself)\n *   capability → the `capability` object (a flat `CapabilityDefinition` — the\n *                pod cache / CP by-key shape — passes through)\n *   automation → `automations[]` (`[]` when the definition declares none)\n *   view       → `views[]`, or a legacy flat view (top-level `type`) as `[def]`, else `[]`\n *   workspace  → the definition itself\n *\n * An empty array means the definition declares none; the install doors refuse\n * that themselves. A definition that is not an object is a failed read, never\n * an empty one: it throws.\n */\nexport function unwrapPackage<K extends WireKindName>(kind: K, definition: unknown): ElementOf<K>;\nexport function unwrapPackage(kind: string, definition: unknown): unknown {\n  const wireKind = toWireKind(kind);\n  if (!wireKind) throw new Error(`unwrapPackage: \"${kind}\" has no wire contract`);\n  if (!isRecord(definition)) {\n    throw new TypeError(\n      `unwrapPackage(${kind}): the definition is not an object (${definition === null ? \"null\" : Array.isArray(definition) ? \"array\" : typeof definition})`,\n    );\n  }\n  switch (wireKind) {\n    case \"skill\":\n      return isRecord(definition.skill) ? definition.skill : definition;\n    case \"capability\":\n      return isRecord(definition.capability) ? definition.capability : definition;\n    case \"automation\":\n      return Array.isArray(definition.automations) ? definition.automations : [];\n    case \"view\":\n      if (Array.isArray(definition.views) && definition.views.length > 0) return definition.views;\n      return definition.type ? [definition] : [];\n    case \"workspace\":\n      return definition;\n  }\n}\n","/**\n * @synap-core/workspace-templates/wire — ONE wire contract per package kind.\n *\n * The per-kind envelopes and `unwrapPackage` live in `./wire-core` (import-free,\n * so it can be mirrored byte-for-byte by consumers still pinned to an older npm\n * copy). This adds what needs the rest of the package: the workspace envelope,\n * derived from `PackageDefinitionOutput` instead of re-declared, and the one\n * workspace wire → create-input translation.\n */\n\nimport type { PackageDefinitionOutput, WorkspaceDefinitionInput } from \"./define\";\nimport { unwrapPackage as unwrapCore, type ElementOf, type WireIdentity, type WireKindName, type WireMeta } from \"./wire-core\";\n\nexport {\n  WIRE_KINDS,\n  WIRE_KIND_ALIASES,\n  toWireKind,\n  type WireKind,\n  type WireKindName,\n  type WireMeta,\n  type WireIdentity,\n  type WireDependency,\n  type WireEnvelope,\n  type CapabilityElement,\n  type CapabilityWire,\n  type SkillElement,\n  type SkillWire,\n  type AutomationElement,\n  type AutomationWire,\n  type ViewElement,\n  type ViewWire,\n  type PackageElementByKind,\n} from \"./wire-core\";\nimport type { AutomationWire, CapabilityWire, SkillWire, ViewWire, WireKind } from \"./wire-core\";\n\n/**\n * workspace / pack: `toPackageDefinition()` output — re-used, not re-declared.\n * As served it is `toOfficialPublishBody().definition` (identity mirrored on\n * top, `sourcePackage`) with `_meta` cut down to what the CP stamps; a bundled\n * `PackageDefinitionOutput` is assignable to it as is.\n */\nexport type WorkspaceWire = Omit<PackageDefinitionOutput, \"_meta\"> &\n  WireIdentity & {\n    _meta?: Partial<PackageDefinitionOutput[\"_meta\"]> & WireMeta;\n    /** Which build of this package generated the row (official rows only). */\n    sourcePackage?: { name: string; version: string };\n  };\n\n/** The served definition, keyed by kind. */\nexport interface PackageWireByKind {\n  workspace: WorkspaceWire;\n  capability: CapabilityWire;\n  skill: SkillWire;\n  automation: AutomationWire;\n  view: ViewWire;\n}\nexport type PackageWire = PackageWireByKind[WireKind];\n\n/** `./wire-core`'s `unwrapPackage`, with the workspace element typed as {@link WorkspaceWire}. */\nexport function unwrapPackage<K extends WireKindName>(kind: K, definition: unknown): ElementOf<K, WorkspaceWire> {\n  return unwrapCore(kind, definition) as ElementOf<K, WorkspaceWire>;\n}\n\n/**\n * The served workspace definition → the input the pod's create/reconcile door\n * takes (`WorkspaceDefinitionInput`). The two renames live here and only here:\n * `suggestedEntities` → `seedEntities` and `automations` (graph flows) →\n * `flowAutomations`.\n *\n * A 1:1 copy of the pod's `toWorkspaceDefinitionInput`\n * (synap-backend `services/capabilities/resolve-workspace-template.ts`), so the\n * pod can import this instead. Like it, it does NOT carry `taskIntents`,\n * `capabilities`, `playbooks`, `actionPlacements`, `rules` or `skills`: the\n * post-workspace layer reads the last five off the package definition itself;\n * `taskIntents` is a gap on that path today. `wire.test.ts` pins every\n * difference from `toWorkspaceDefinition`.\n */\nexport function toWorkspaceInput(pkg: WorkspaceWire): WorkspaceDefinitionInput {\n  return {\n    workspaceName: pkg.workspaceName,\n    description: pkg.description,\n    proposalId: pkg._meta?.slug,\n    profiles: pkg.profiles,\n    views: pkg.views ?? [],\n    entityLinks: pkg.entityLinks ?? [],\n    seedEntities: pkg.suggestedEntities ?? [],\n    suggestedRelations: pkg.suggestedRelations,\n    displayTemplates: pkg.displayTemplates,\n    layoutConfig: pkg.layoutConfig,\n    bentoViewName: pkg.bentoViewName,\n    bentoLayout: pkg.bentoLayout,\n    bentoViewBlocks: pkg.bentoViewBlocks,\n    profileEntityBentoTemplates: pkg.profileEntityBentoTemplates,\n    workspaceSubtype: pkg.workspaceSubtype,\n    workspaceType: pkg.workspaceType,\n    workspaceVisibility: pkg.workspaceVisibility,\n    workspaceCapabilities: pkg.workspaceCapabilities,\n    intent: pkg.intent,\n    sourceRoles: pkg.sourceRoles,\n    defaultSources: pkg.defaultSources,\n    onboarding: pkg.onboarding,\n    dependencies: pkg.dependencies,\n    flowAutomations: pkg.automations ?? [],\n    commands: pkg.commands ?? [],\n    relationDefs: pkg.relationDefs ?? [],\n  };\n}\n"],"mappings":";AA4BO,IAAM,aAAa,CAAC,aAAa,cAAc,SAAS,cAAc,MAAM;AAQ5E,IAAM,oBAAoB;AAAA,EAC/B,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AACZ;AAIO,SAAS,WAAW,MAA+B;AACxD,MAAK,WAAiC,SAAS,IAAI,EAAG,QAAO;AAC7D,SAAQ,kBAA+C,IAAI,KAAK;AAClE;AAgJA,IAAM,WAAW,CAAC,MAChB,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,CAAC;AAiBlD,SAAS,cAAc,MAAc,YAA8B;AACxE,QAAM,WAAW,WAAW,IAAI;AAChC,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,mBAAmB,IAAI,wBAAwB;AAC9E,MAAI,CAAC,SAAS,UAAU,GAAG;AACzB,UAAM,IAAI;AAAA,MACR,iBAAiB,IAAI,uCAAuC,eAAe,OAAO,SAAS,MAAM,QAAQ,UAAU,IAAI,UAAU,OAAO,UAAU;AAAA,IACpJ;AAAA,EACF;AACA,UAAQ,UAAU;AAAA,IAChB,KAAK;AACH,aAAO,SAAS,WAAW,KAAK,IAAI,WAAW,QAAQ;AAAA,IACzD,KAAK;AACH,aAAO,SAAS,WAAW,UAAU,IAAI,WAAW,aAAa;AAAA,IACnE,KAAK;AACH,aAAO,MAAM,QAAQ,WAAW,WAAW,IAAI,WAAW,cAAc,CAAC;AAAA,IAC3E,KAAK;AACH,UAAI,MAAM,QAAQ,WAAW,KAAK,KAAK,WAAW,MAAM,SAAS,EAAG,QAAO,WAAW;AACtF,aAAO,WAAW,OAAO,CAAC,UAAU,IAAI,CAAC;AAAA,IAC3C,KAAK;AACH,aAAO;AAAA,EACX;AACF;;;AC3KO,SAASA,eAAsC,MAAS,YAAkD;AAC/G,SAAO,cAAW,MAAM,UAAU;AACpC;AAgBO,SAAS,iBAAiB,KAA8C;AAC7E,SAAO;AAAA,IACL,eAAe,IAAI;AAAA,IACnB,aAAa,IAAI;AAAA,IACjB,YAAY,IAAI,OAAO;AAAA,IACvB,UAAU,IAAI;AAAA,IACd,OAAO,IAAI,SAAS,CAAC;AAAA,IACrB,aAAa,IAAI,eAAe,CAAC;AAAA,IACjC,cAAc,IAAI,qBAAqB,CAAC;AAAA,IACxC,oBAAoB,IAAI;AAAA,IACxB,kBAAkB,IAAI;AAAA,IACtB,cAAc,IAAI;AAAA,IAClB,eAAe,IAAI;AAAA,IACnB,aAAa,IAAI;AAAA,IACjB,iBAAiB,IAAI;AAAA,IACrB,6BAA6B,IAAI;AAAA,IACjC,kBAAkB,IAAI;AAAA,IACtB,eAAe,IAAI;AAAA,IACnB,qBAAqB,IAAI;AAAA,IACzB,uBAAuB,IAAI;AAAA,IAC3B,QAAQ,IAAI;AAAA,IACZ,aAAa,IAAI;AAAA,IACjB,gBAAgB,IAAI;AAAA,IACpB,YAAY,IAAI;AAAA,IAChB,cAAc,IAAI;AAAA,IAClB,iBAAiB,IAAI,eAAe,CAAC;AAAA,IACrC,UAAU,IAAI,YAAY,CAAC;AAAA,IAC3B,cAAc,IAAI,gBAAgB,CAAC;AAAA,EACrC;AACF;","names":["unwrapPackage"]}

package/package.json

@@ -1,51 +1,65 @@
 {
   "name": "@synap-core/workspace-templates",
-  "version": "0.11.0",
+  "version": "0.23.0",
   "type": "module",
-  "packageManager": "pnpm@9.15.4",
   "description": "Canonical workspace definitions — YAML source + typed exports for browser, backend, CLI, and marketplace",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Synap-core/app-bases.git",
+    "directory": "packages/workspace-templates"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "node": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./wire": {
+      "types": "./dist/wire.d.ts",
+      "default": "./dist/wire.js"
+    },
+    "./capabilities/*": "./capabilities/*",
+    "./skills/*": "./skills/*",
+    "./packs/*": "./packs/*",
+    "./automations/*": "./automations/*",
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "capabilities",
+    "skills",
+    "packs",
+    "automations",
+    "retired.yaml"
   ],
-  "scripts": {
-    "type-check": "tsc --noEmit",
-    "build:yaml": "node --experimental-strip-types build.mjs",
-    "check:converters": "node scripts/check-converters.mjs",
-    "check:concepts": "node scripts/check-concepts.mjs",
-    "build": "node --experimental-strip-types build.mjs && tsup && node scripts/check-converters.mjs && node scripts/check-concepts.mjs",
-    "provision": "node scripts/provision.mjs",
-    "eval": "node scripts/eval-standard.mjs",
-    "prepublishOnly": "node --experimental-strip-types build.mjs && tsup && node scripts/check-converters.mjs && node scripts/check-concepts.mjs"
-  },
   "dependencies": {
+    "@synap-core/types": "^1.12.0",
     "zod": "^3.0.0",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
+    "esbuild": "^0.27.3",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
-    "access": "public",
-    "main": "./dist/index.js",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-      ".": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    }
-  }
-}
+    "access": "public"
+  },
+  "scripts": {
+    "type-check": "tsc -p tsconfig.catalog.json && tsc --noEmit",
+    "type-check:catalog": "tsc -p tsconfig.catalog.json",
+    "build:yaml": "node --experimental-strip-types build.mjs",
+    "build:space-packages": "node scripts/build-space-packages.mjs",
+    "check:converters": "node scripts/check-converters.mjs",
+    "check:concepts": "node scripts/check-concepts.mjs",
+    "build": "node --experimental-strip-types build.mjs && tsup && node scripts/check-converters.mjs && node scripts/check-concepts.mjs",
+    "provision": "node scripts/provision.mjs",
+    "eval": "node scripts/eval-standard.mjs"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/packs/bookmark-views-pack.json

@@ -0,0 +1,33 @@
+{
+  "_meta": {
+    "slug": "bookmark-views-pack",
+    "displayName": "Bookmark Views",
+    "icon": "bookmark",
+    "color": "#F59E0B",
+    "tags": ["bookmarks", "reading", "web", "views"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "description": "Three ready-made views for saved links and articles: a masonry reading feed, a gallery and an articles table.",
+  "profiles": [],
+  "views": [
+    {
+      "name": "Reading Feed",
+      "type": "masonry",
+      "scopeProfileSlugs": ["bookmark", "website", "article"],
+      "config": {}
+    },
+    {
+      "name": "Bookmark Gallery",
+      "type": "gallery",
+      "scopeProfileSlugs": ["bookmark", "website", "article"],
+      "config": {}
+    },
+    {
+      "name": "Articles Table",
+      "type": "table",
+      "scopeProfileSlug": "article",
+      "config": {}
+    }
+  ]
+}

package/packs/crm-pack.json

@@ -0,0 +1,76 @@
+{
+  "_meta": {
+    "slug": "crm-pack",
+    "icon": "users",
+    "color": "#3B82F6",
+    "tags": ["crm", "sales", "contacts", "deals"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "contact",
+      "displayName": "Contact",
+      "icon": "user-check",
+      "color": "#06B6D4",
+      "description": "People you interact with",
+      "scope": "workspace",
+      "parentProfileSlug": "person",
+      "properties": [
+        { "slug": "role", "valueType": "string", "label": "Role / Title" },
+        { "slug": "department", "valueType": "string", "label": "Department" },
+        { "slug": "source", "valueType": "string", "label": "Lead Source", "inputType": "select", "enumValues": ["referral", "website", "event", "cold-outreach", "other"] },
+        { "slug": "last-contacted", "valueType": "date", "label": "Last Contacted" }
+      ]
+    },
+    {
+      "slug": "company",
+      "displayName": "Company",
+      "icon": "building",
+      "color": "#6366F1",
+      "description": "Organizations and businesses",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "website", "valueType": "string", "label": "Website", "inputType": "url" },
+        { "slug": "industry", "valueType": "string", "label": "Industry" },
+        { "slug": "employees", "valueType": "number", "label": "Employee Count", "constraints": { "min": 0 } },
+        { "slug": "location", "valueType": "string", "label": "Location" },
+        { "slug": "revenue", "valueType": "number", "label": "Annual Revenue", "constraints": { "min": 0 } }
+      ]
+    },
+    {
+      "slug": "deal",
+      "displayName": "Deal",
+      "icon": "trending-up",
+      "color": "#EC4899",
+      "description": "Sales opportunities and pipeline",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "value", "valueType": "number", "required": true, "label": "Deal Value", "constraints": { "min": 0 } },
+        { "slug": "stage", "valueType": "string", "required": true, "label": "Stage", "inputType": "select", "enumValues": ["lead", "qualified", "proposal", "negotiation", "closed-won", "closed-lost"] },
+        { "slug": "close-date", "valueType": "date", "label": "Expected Close" },
+        { "slug": "probability", "valueType": "number", "label": "Win Probability (%)", "constraints": { "min": 0, "max": 100 } },
+        { "slug": "notes", "valueType": "string", "label": "Notes", "inputType": "textarea" }
+      ]
+    }
+  ],
+  "views": [
+    {
+      "name": "Pipeline",
+      "type": "kanban",
+      "scopeProfileSlug": "deal",
+      "config": { "groupByField": "stage" }
+    },
+    {
+      "name": "Contacts",
+      "type": "table",
+      "scopeProfileSlug": "contact",
+      "config": {}
+    }
+  ],
+  "entityLinks": [
+    { "sourceProfileSlug": "contact", "targetProfileSlug": "company", "type": "works_at", "label": "Works at" },
+    { "sourceProfileSlug": "deal", "targetProfileSlug": "contact", "type": "owned_by", "label": "Owned by" },
+    { "sourceProfileSlug": "deal", "targetProfileSlug": "company", "type": "deal_for", "label": "Deal for" }
+  ]
+}

package/packs/customer-profile.json

@@ -0,0 +1,28 @@
+{
+  "_meta": {
+    "slug": "customer-profile",
+    "icon": "user-check",
+    "color": "#3B82F6",
+    "tags": ["customer", "crm", "contact"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "customer",
+      "displayName": "Customer",
+      "icon": "user-check",
+      "color": "#3B82F6",
+      "description": "Customer or client contact with deal tracking",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "name", "valueType": "string", "required": true, "label": "Full Name" },
+        { "slug": "email", "valueType": "string", "label": "Email", "inputType": "email" },
+        { "slug": "phone", "valueType": "string", "label": "Phone" },
+        { "slug": "company", "valueType": "string", "label": "Company" },
+        { "slug": "status", "valueType": "string", "label": "Status", "inputType": "select", "enumValues": ["lead", "prospect", "active", "churned"] },
+        { "slug": "notes", "valueType": "string", "label": "Notes", "inputType": "textarea" }
+      ]
+    }
+  ]
+}

package/packs/deep-research.playbook.json

@@ -0,0 +1,30 @@
+{
+  "_meta": {
+    "slug": "deep-research",
+    "type": "playbook",
+    "icon": "search",
+    "color": "#10B981",
+    "tags": ["research", "analysis", "automation"],
+    "isPublic": true,
+    "description": "Autonomous deep research playbook. Researches a domain, finds the best tools/platforms, and produces a CSV report and entity pool."
+  },
+  "name": "Deep Research",
+  "goalTemplate": "Research {domain}. Find the best {category} and produce: {outputTypes}. Use the provided company context where relevant.",
+  "description": "Researches a domain, identifies the best tools and platforms, produces structured outputs.",
+  "params": [
+    { "name": "domain", "type": "string", "default": "AI coding tools" },
+    { "name": "category", "type": "string", "default": "platforms and frameworks" },
+    { "name": "outputTypes", "type": "string", "default": "CSV file and entity pool" },
+    { "name": "companyContext", "type": "string", "default": "" }
+  ],
+  "executor": "is-agent",
+  "grants": [
+    { "kind": "tool", "ref": "Web Search" },
+    { "kind": "skill", "ref": "Entity Creator" }
+  ],
+  "expectedOutputs": [
+    { "description": "Research findings as structured CSV", "type": "csv" },
+    { "description": "Entity pool of discovered tools and companies", "type": "entities" },
+    { "description": "Summary report with recommendations", "type": "report" }
+  ]
+}

package/packs/event-views-pack.json

@@ -0,0 +1,33 @@
+{
+  "_meta": {
+    "slug": "event-views-pack",
+    "displayName": "Event Views",
+    "icon": "calendar",
+    "color": "#10B981",
+    "tags": ["events", "calendar", "schedule", "views"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "description": "Three ready-made event views: a calendar, an upcoming-events list and an events table.",
+  "profiles": [],
+  "views": [
+    {
+      "name": "Event Calendar",
+      "type": "calendar",
+      "scopeProfileSlug": "event",
+      "config": { "dateField": "startDate", "endDateField": "endDate" }
+    },
+    {
+      "name": "Upcoming Events",
+      "type": "list",
+      "scopeProfileSlug": "event",
+      "config": { "sortBy": "startDate", "sortOrder": "asc" }
+    },
+    {
+      "name": "Events Table",
+      "type": "table",
+      "scopeProfileSlug": "event",
+      "config": {}
+    }
+  ]
+}