@synap-core/workspace-templates 0.6.2 → 0.6.4

package/dist/index.d.ts

@@ -150,13 +150,6 @@ interface TemplateProfileEntityBentoTemplates {
         blocks: Array<Record<string, unknown>>;
     };
 }
-interface TemplateAutomation {
-    name: string;
-    description?: string;
-    trigger: string;
-    action: string;
-    config?: Record<string, unknown>;
-}
 /** Mirrors `WorkspaceSourceRole` in synap-backend `schema/workspaces.ts`. */
 type TemplateSourceRole = 'provider' | 'consumer' | 'provider-consumer';
 /** Mirrors `WorkspaceDefaultSource` in synap-backend `schema/workspaces.ts`. */
@@ -411,8 +404,6 @@ interface WorkspaceYaml {
     };
     /** Per-profile entity bento layouts */
     profileEntityBentoTemplates?: TemplateProfileEntityBentoTemplates;
-    /** Automations to install on workspace creation */
-    automations?: TemplateAutomation[];
     /** Playbooks (session templates) seeded with the workspace */
     playbooks?: TemplatePlaybook[];
     /** Capability templates (tools/connectors) to install on provisioning */
@@ -546,6 +537,42 @@ interface MergeCatalogInput {
      */
     remoteStatus?: RemoteSourceStatus;
 }
+/**
+ * A control-plane package LIST row, as returned by `GET /api/packages` and
+ * `GET /api/packages/mine`. This is the raw JSON shape BEFORE it is projected
+ * into a `RemoteEntry`. Both list routes STRIP `definition`, so it is absent
+ * here (the install path fetches the full row per-slug on demand).
+ *
+ * `isPublic` is present ONLY on `/mine` rows (`false` ⇒ private). Public browse
+ * rows omit it BY CONSTRUCTION (the list route hard-filters `WHERE is_public =
+ * true`), so its absence means "public", never "unknown".
+ *
+ * Consumers used to hand-copy this shape + `rowToRemoteEntry` (browser
+ * `useMarketplaceCatalog`, CLI `cp-packages`); this is the ONE canonical copy.
+ */
+interface CpPackageRow {
+    slug: string;
+    displayName: string;
+    description?: string | null;
+    /** CP package category / type (e.g. `"workspace"`, `"view"`). */
+    category?: string;
+    tags?: string[] | null;
+    icon?: string | null;
+    /** Present only on `/mine` rows. `false` ⇒ private. Browse rows omit it. */
+    isPublic?: boolean;
+}
+/**
+ * Map a CP list row into the merge door's `RemoteEntry`. THE canonical mapping —
+ * browser + CLI import this instead of hand-copying it (the two copies had
+ * already drifted in `description`/`isPrivate` handling).
+ *
+ * `isPrivate` is passed EXPLICITLY by the caller because it depends on WHICH
+ * route the row came from: browse rows are all-public (pass `undefined`), `/mine`
+ * rows carry the real flag (pass `row.isPublic === false`). Keeping it a param —
+ * not derived here — lets a caller that fetches the two routes separately control
+ * it per-source; `assembleCatalog` derives it from the row for the common case.
+ */
+declare function rowToRemoteEntry(row: CpPackageRow, isPrivate?: boolean): RemoteEntry;
 interface CatalogEntryBase {
     slug: string;
     name: string;
@@ -602,6 +629,71 @@ interface MergeCatalogResult {
  * entry (a private or third-party package) and is always kept.
  */
 declare function mergeCatalog(input: MergeCatalogInput): MergeCatalogResult;
+interface AssembleCatalogInput {
+    /** Bundled templates (this package). Always in-process. */
+    bundled: BundledEntry[];
+    /**
+     * Raw CP list rows (browse and/or `/mine`, concatenated). Mapped to
+     * `RemoteEntry` via `rowToRemoteEntry`; `isPrivate` is DERIVED per-row from
+     * `isPublic` (`false` ⇒ private; absent/`true` ⇒ public), which handles both
+     * browse rows (no `isPublic`) and `/mine` rows uniformly.
+     */
+    remoteRows?: CpPackageRow[];
+    /** This client's bundled-package version (the winner signal vs each row). */
+    bundleVersion: string;
+    /** The transport's verdict on the remote fetch. Default `"ok"`. */
+    remoteStatus?: RemoteSourceStatus;
+}
+/**
+ * Convenience wrapper over `mergeCatalog`: maps raw CP rows through the canonical
+ * `rowToRemoteEntry` and merges them with the bundled templates. Still PURE — the
+ * caller fetches the rows (its own transport/auth) and passes them in; this only
+ * maps + merges. Use `mergeCatalog` + `rowToRemoteEntry` directly when you need
+ * per-source `isPrivate` control (e.g. keeping browse and `/mine` distinct).
+ */
+declare function assembleCatalog(input: AssembleCatalogInput): MergeCatalogResult;
+/** A template a pod has installed — the door reads `settings.packageVersion` off the workspace row. */
+interface InstalledTemplate {
+    slug: string;
+    version: string;
+}
+/** Per-slug verdict: is a newer catalog version available than what's installed? */
+interface TemplateUpdateCheck {
+    slug: string;
+    installedVersion: string;
+    /** `undefined` when the slug has no matching catalog entry, or a bundled winner and no `bundleVersion` was passed. */
+    latestVersion: string | undefined;
+    updateAvailable: boolean;
+    /** Passed through from the winning catalog entry, so callers can route private updates through the authed path. */
+    isPrivate?: boolean;
+}
+/**
+ * `true` when `version` is a CP content-hash stamp (`"h-<hash>"`) rather than semver.
+ * Content-hash versions are NOT semver-comparable — see `computeTemplateUpdates`.
+ */
+declare function isHashVersion(version: string | undefined): boolean;
+/**
+ * Compute, per installed template, whether the CATALOG (bundled + remote,
+ * already merged by `mergeCatalog`/`assembleCatalog`) carries a newer version
+ * than what the pod installed — the shared "update available" check all three
+ * doors (browser, synap-app, CLI) reuse instead of re-deriving it.
+ *
+ * `installed` and `catalog` are BOTH already-fetched/computed by the caller —
+ * this stays PURE, same as the rest of this module (no fetch, no auth).
+ *
+ * The catalog's winning entry carries the latest version signal two ways:
+ *   • `source: "remote"` → `remote.definition?.sourcePackage?.version` (semver
+ *     OR, going forward, a CP content-hash `"h-<hash>"` stamp).
+ *   • `source: "bundled"` → bundled entries carry no version field at all
+ *     (`TemplateMeta` has none); pass `bundleVersion` (this client's compiled
+ *     package version, the same value fed to `mergeCatalog`) to compare against
+ *     it. Omit `bundleVersion` and bundled-backed slugs report `latestVersion:
+ *     undefined, updateAvailable: false` (nothing comparable).
+ *
+ * A slug with no matching catalog entry ⇒ `updateAvailable: false`,
+ * `latestVersion: undefined` — there is nothing to update TO.
+ */
+declare function computeTemplateUpdates(installed: InstalledTemplate[], catalog: CatalogEntry[], bundleVersion?: string): TemplateUpdateCheck[];
 
 /**
  * @synap-core/workspace-templates — Definition adapter
@@ -657,6 +749,18 @@ interface WorkspaceDefinitionInput {
     /** VIEW half of the authored bento union — resolved against the viewMap. */
     bentoViewBlocks?: BentoViewBlockWire[];
     profileEntityBentoTemplates?: WorkspaceYaml['profileEntityBentoTemplates'];
+    /**
+     * Capability integrations (→ tools + skills + vault + capability-embedded
+     * automations/playbooks). Emitted from the template's `integrations:` list —
+     * IDENTICAL to what `toPackageDefinition` puts in its `capabilities` field. The
+     * tRPC door (`workspaces.createFromDefinition`) now declares `capabilities` in
+     * its zod input and installs them via the SHARED `applyPackagePostWorkspace`
+     * door (same as Hub `/packages/apply`). It was missing from this interface, so
+     * `toWorkspaceDefinition` had nowhere to put integrations and the browser
+     * BUNDLED install path carried NO capabilities — every capability's
+     * tools/skills/automations silently dropped on that door.
+     */
+    capabilities?: WorkspaceYaml['integrations'];
     workspaceSubtype?: string;
     workspaceType?: NonNullable<WorkspaceYaml['workspace']>['workspaceType'];
     workspaceVisibility?: string;
@@ -748,4 +852,4 @@ interface PackageDefinitionOutput {
  */
 declare function toPackageDefinition(slugOrYaml: string | WorkspaceYaml): PackageDefinitionOutput;
 
-export { type BentoViewBlockWire, type BentoWidgetBlockWire, type BundledCatalogEntry, type BundledEntry, type CatalogEntry, type MergeCatalogInput, type MergeCatalogResult, PACKAGE_DEPENDENCY_KINDS, type PackageDefinitionOutput, type PackageDependencyKind, type RemoteCatalogEntry, type RemoteEntry, type RemoteSourceStatus, type SplitBentoBlocks, type TemplateAppKind, type TemplateAppRef, type TemplateAutomation, type TemplateBentoBlock, type TemplateDefaultSource, type TemplateDependency, type TemplateDisplayTemplate, type TemplateEntityLink, type TemplateExtendsRef, type TemplateIntegration, type TemplateLayoutConfig, type TemplateMeta, type TemplateOnboarding, type TemplateOnboardingCollectTarget, type TemplatePlaybook, type TemplatePlaybookParam, type TemplateProfile, type TemplateProfileEntityBentoTemplates, type TemplateProperty, type TemplateSeedEntity, type TemplateSidebarItem, type TemplateSidebarSurface, type TemplateSourceRole, type TemplateSuggestedRelation, type TemplateView, type ToDefinitionResult, WORKSPACE_TEMPLATES, type WorkspaceDefinitionInput, type WorkspaceTemplateSlug, type WorkspaceYaml, getWorkspaceTemplate, listPublicTemplates, listWorkspaceTemplates, mergeCatalog, splitBentoBlocks, toPackageDefinition, toWorkspaceDefinition };
+export { type AssembleCatalogInput, type BentoViewBlockWire, type BentoWidgetBlockWire, type BundledCatalogEntry, type BundledEntry, type CatalogEntry, type CpPackageRow, type InstalledTemplate, type MergeCatalogInput, type MergeCatalogResult, PACKAGE_DEPENDENCY_KINDS, type PackageDefinitionOutput, type PackageDependencyKind, type RemoteCatalogEntry, type RemoteEntry, type RemoteSourceStatus, type SplitBentoBlocks, type TemplateAppKind, type TemplateAppRef, type TemplateBentoBlock, type TemplateDefaultSource, type TemplateDependency, type TemplateDisplayTemplate, type TemplateEntityLink, type TemplateExtendsRef, type TemplateIntegration, type TemplateLayoutConfig, type TemplateMeta, type TemplateOnboarding, type TemplateOnboardingCollectTarget, type TemplatePlaybook, type TemplatePlaybookParam, type TemplateProfile, type TemplateProfileEntityBentoTemplates, type TemplateProperty, type TemplateSeedEntity, type TemplateSidebarItem, type TemplateSidebarSurface, type TemplateSourceRole, type TemplateSuggestedRelation, type TemplateUpdateCheck, type TemplateView, type ToDefinitionResult, WORKSPACE_TEMPLATES, type WorkspaceDefinitionInput, type WorkspaceTemplateSlug, type WorkspaceYaml, assembleCatalog, computeTemplateUpdates, getWorkspaceTemplate, isHashVersion, listPublicTemplates, listWorkspaceTemplates, mergeCatalog, rowToRemoteEntry, splitBentoBlocks, toPackageDefinition, toWorkspaceDefinition };

package/dist/index.js

@@ -8485,6 +8485,16 @@ var DATA = {
         "groupBy": "post-status",
         "description": "Content posts by status."
       },
+      {
+        "name": "Content Calendar",
+        "slug": "content-calendar",
+        "type": "calendar",
+        "scopeProfileSlug": "post",
+        "description": "Your editorial calendar \u2014 every post on the day it publishes.",
+        "config": {
+          "dateField": "properties.publish-date"
+        }
+      },
       {
         "name": "Pillars",
         "slug": "content-pillars",
@@ -8526,6 +8536,12 @@ var DATA = {
           "label": "Posts",
           "icon": "file-edit"
         },
+        {
+          "kind": "view",
+          "viewName": "Content Calendar",
+          "label": "Calendar",
+          "icon": "calendar"
+        },
         {
           "kind": "view",
           "viewName": "Pillars",
@@ -8551,10 +8567,20 @@ var DATA = {
       "blocks": [
         {
           "kind": "view",
-          "viewName": "Pillars",
+          "viewName": "Content Calendar",
           "pos": {
             "x": 0,
             "y": 0,
+            "w": 12,
+            "h": 6
+          }
+        },
+        {
+          "kind": "view",
+          "viewName": "Pillars",
+          "pos": {
+            "x": 0,
+            "y": 6,
             "w": 6,
             "h": 5
           }
@@ -8564,7 +8590,7 @@ var DATA = {
           "viewName": "Newsletters",
           "pos": {
             "x": 6,
-            "y": 0,
+            "y": 6,
             "w": 6,
             "h": 5
           }
@@ -9744,6 +9770,62 @@ var DATA = {
         "targetProfileSlug": "deal",
         "type": "linked_to_deal"
       }
+    ],
+    "playbooks": [
+      {
+        "name": "Enrich this lead",
+        "description": "Take a thin, freshly-captured lead and fill it out \u2014 company, title, LinkedIn, and the relationships around it.",
+        "goalTemplate": "Enrich this lead ({lead}). Starting from whatever is known, fill out the missing detail \u2014 company, job title, LinkedIn URL, location, and the people and companies around them \u2014 and record it on the lead. Draw on whatever enrichment capability this workspace has connected (e.g. an Apify or Unipile/LinkedIn tool); if none is available, enrich from the public web and what is already in the pod. Link the lead to its company and any related contacts, and note where information is still missing.",
+        "subjectProfile": {
+          "profileSlug": "lead"
+        },
+        "params": [
+          {
+            "name": "lead",
+            "type": "entity",
+            "label": "Lead",
+            "required": true
+          }
+        ],
+        "executor": "is-agent",
+        "status": "active"
+      },
+      {
+        "name": "Qualify this lead",
+        "description": "Assess a lead against the ICP, score the fit, and decide the next step \u2014 advance, nurture, or disqualify.",
+        "goalTemplate": "Qualify this lead ({lead}). Assess how well they fit our ideal customer profile \u2014 company, role, industry, size, and the signals of intent or need \u2014 and set an ICP score. Decide the next step: advance them toward a deal, keep nurturing, or disqualify. Write the reasoning and the decision back onto the lead (its stage, score, and next step) so the call is auditable.",
+        "subjectProfile": {
+          "profileSlug": "lead"
+        },
+        "params": [
+          {
+            "name": "lead",
+            "type": "entity",
+            "label": "Lead",
+            "required": true
+          }
+        ],
+        "executor": "is-agent",
+        "status": "active"
+      },
+      {
+        "name": "Work this deal",
+        "description": "Move a deal toward Won \u2014 read the current stage, find the blocker, and propose the next step and owner.",
+        "goalTemplate": "Work this deal ({deal}) toward Won. Assess where it stands \u2014 its current stage, value, and close date \u2014 and identify the single thing blocking it from advancing. Propose the concrete next step, who owns it, and by when, and update the deal's next step accordingly. If the stage should change, say so and why.",
+        "subjectProfile": {
+          "profileSlug": "deal"
+        },
+        "params": [
+          {
+            "name": "deal",
+            "type": "entity",
+            "label": "Deal",
+            "required": true
+          }
+        ],
+        "executor": "is-agent",
+        "status": "active"
+      }
     ]
   },
   "dev-dashboard": {
@@ -12026,11 +12108,43 @@ var DATA = {
           }
         ],
         "executor": "is-agent",
+        "schedule": {
+          "cron": "0 9 * * 1",
+          "enabled": false
+        },
         "grants": [
           "Web Search",
           "Entity Creator"
         ],
         "status": "active"
+      },
+      {
+        "name": "Discover Competitors",
+        "description": "Scan the market for competitors we don't track yet and add them to the ecosystem \u2014 the self-generating half of the radar.",
+        "goalTemplate": 'Find companies that compete with us in {ourSpace}. Use neural web search (the exa_search skill with category "company") to surface real, named companies \u2014 direct competitors, adjacent tools that solve the same job a different way, and emerging players. For each genuinely NEW one (not already a competitor in our ecosystem), propose it as a `competitor` entity and ALWAYS include its `website` (its canonical URL) so it de-duplicates against what we already track \u2014 never create a company that already exists. Skip anything already known. Report what you added and why each one matters.',
+        "schedule": {
+          "cron": "0 9 * * 1",
+          "enabled": false
+        },
+        "params": [
+          {
+            "name": "ourSpace",
+            "type": "text",
+            "label": "Our market / category",
+            "required": true
+          }
+        ],
+        "executor": "is-agent",
+        "grants": [
+          "exa_search",
+          "Entity Creator"
+        ],
+        "status": "active"
+      }
+    ],
+    "integrations": [
+      {
+        "templateKey": "exa"
       }
     ],
     "onboarding": {
@@ -24924,6 +25038,19 @@ function listPublicTemplates() {
 }
 
 // src/catalog.ts
+function rowToRemoteEntry(row, isPrivate) {
+  return {
+    slug: row.slug,
+    name: row.displayName,
+    description: row.description ?? void 0,
+    category: row.category,
+    tags: row.tags ?? [],
+    icon: row.icon ?? null,
+    isPrivate
+    // Both list routes strip `definition`; absence ⇒ bundle wins a slug conflict,
+    // and the install path fetches the full definition per-slug when needed.
+  };
+}
 function parseSemver(v) {
   if (!v) return null;
   const m = /^\s*v?(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -24998,6 +25125,44 @@ function mergeCatalog(input) {
     sources: { bundled: "ok", remote: remoteStatus }
   };
 }
+function assembleCatalog(input) {
+  const remote = (input.remoteRows ?? []).map(
+    (row) => rowToRemoteEntry(row, row.isPublic === false ? true : void 0)
+  );
+  return mergeCatalog({
+    bundled: input.bundled,
+    remote,
+    bundleVersion: input.bundleVersion,
+    remoteStatus: input.remoteStatus
+  });
+}
+function isHashVersion(version) {
+  return typeof version === "string" && version.startsWith("h-");
+}
+function isNewerVersion(installedVersion, latestVersion) {
+  if (latestVersion === void 0) return false;
+  if (isHashVersion(installedVersion) || isHashVersion(latestVersion)) {
+    return installedVersion !== latestVersion;
+  }
+  return remoteIsStrictlyNewer(latestVersion, installedVersion);
+}
+function computeTemplateUpdates(installed, catalog, bundleVersion) {
+  const bySlug = new Map(catalog.map((entry) => [entry.slug, entry]));
+  return installed.map(({ slug, version: installedVersion }) => {
+    const entry = bySlug.get(slug);
+    if (!entry) {
+      return { slug, installedVersion, latestVersion: void 0, updateAvailable: false };
+    }
+    const latestVersion = entry.source === "remote" ? entry.remote.definition?.sourcePackage?.version : bundleVersion;
+    return {
+      slug,
+      installedVersion,
+      latestVersion,
+      updateAvailable: isNewerVersion(installedVersion, latestVersion),
+      isPrivate: entry.isPrivate
+    };
+  });
+}
 
 // src/define.ts
 function resolveBlockKind(block) {
@@ -25054,6 +25219,13 @@ function toWorkspaceDefinition(slugOrYaml, nameOverride) {
     bentoLayout: bento.bentoLayout,
     bentoViewBlocks: bento.bentoViewBlocks,
     profileEntityBentoTemplates: tpl.profileEntityBentoTemplates,
+    // Capability integrations — forwarded so the tRPC/UI (bundled) install door
+    // seeds the SAME operational payload (tools + skills + capability-embedded
+    // automations/playbooks) the CLI/Hub door gets via `toPackageDefinition`.
+    // `workspaces.createFromDefinition` declares `capabilities` in its zod input
+    // and routes it through the shared `applyPackagePostWorkspace` door. Omitting
+    // it here made the browser bundled-install path carry no capabilities at all.
+    capabilities: tpl.integrations,
     workspaceSubtype: ws.subtype,
     workspaceType: ws.workspaceType,
     workspaceVisibility: ws.visibility,
@@ -25118,10 +25290,14 @@ function toPackageDefinition(slugOrYaml) {
 export {
   PACKAGE_DEPENDENCY_KINDS,
   WORKSPACE_TEMPLATES,
+  assembleCatalog,
+  computeTemplateUpdates,
   getWorkspaceTemplate,
+  isHashVersion,
   listPublicTemplates,
   listWorkspaceTemplates,
   mergeCatalog,
+  rowToRemoteEntry,
   splitBentoBlocks,
   toPackageDefinition,
   toWorkspaceDefinition