@ekanos/cli 0.15.0 → 0.17.0

package/dist/commands/catalog.d.ts

@@ -10,8 +10,10 @@ export interface CatalogArgs {
 }
 /**
  * `catalog` — what the Source can already do (plan 239.0). Lists every
- * product the Source can use, with its tools, agent events and the steps
- * left to set it up; `ekanos catalog <product>` shows one in full.
+ * product the Source can use, Experiences then Integrations as `ekanos
+ * sources products` splits them, with its tools, agent events and the steps
+ * left to set it up; `ekanos catalog <product>` shows one in full, with each
+ * tool's inputs and whose connection an agent run uses.
  *
  * Read before building: an agent migration asks it first, so a capability
  * the Source already has is set up rather than rebuilt. Works outside a

package/dist/commands/catalog.js

@@ -7,8 +7,10 @@ import { pluralize } from '../ui.js';
 import { withDocsHint } from './agents-init.js';
 /**
  * `catalog` — what the Source can already do (plan 239.0). Lists every
- * product the Source can use, with its tools, agent events and the steps
- * left to set it up; `ekanos catalog <product>` shows one in full.
+ * product the Source can use, Experiences then Integrations as `ekanos
+ * sources products` splits them, with its tools, agent events and the steps
+ * left to set it up; `ekanos catalog <product>` shows one in full, with each
+ * tool's inputs and whose connection an agent run uses.
  *
  * Read before building: an agent migration asks it first, so a capability
  * the Source already has is set up rather than rebuilt. Works outside a
@@ -29,42 +31,70 @@ export async function runCatalog(ctx, args) {
         result = await fetchSourceCatalog(env.host, session.accessToken, query);
     }
     const catalog = requireCatalog(result, env);
-    return ctx.succeed(Object.assign({ host: env.host }, catalog), withDocsHint(ctx.ui, args.dir, args.product
+    // The agent-design tip belongs on the overview only, not every product.
+    return ctx.succeed(Object.assign({ host: env.host }, catalog), args.product
         ? productDetail(ctx.ui, catalog.products[0])
-        : catalogSummary(ctx.ui, catalog)));
+        : withDocsHint(ctx.ui, args.dir, catalogSummary(ctx.ui, catalog)));
 }
 function requireCatalog(result, env) {
     if (result.status === 'ok')
         return result.catalog;
     throw authRequiredError(`The session for ${env.host} could not authorize the catalog read.`, loginHint(env));
 }
-const AVAILABILITY_LABEL = {
+const STATUS_LABEL = {
     enabled: 'Enabled on this Source',
-    'turned-off': 'Not enabled — granted, but switched off',
-    available: 'Not enabled — only a super-admin enables it',
+    'turned-off': 'Not enabled — granted, but a Flag or plan switches it off',
+    available: 'Not enabled',
+};
+const SHORT_STATUS = {
+    enabled: '✓ enabled',
+    'turned-off': '✗ switched off',
+    available: '✗ not enabled',
+};
+/** Who does a setup step, in words. The wire value `ekanos` is Vastly. */
+const ACTOR_LABEL = {
+    ekanos: 'Vastly',
+    source_admin: 'Source admin',
+    team: 'team',
+};
+/** A `team` step on a per-person product is each person's to do. */
+function actorLabel(actor, product) {
+    return actor === 'team' && product.scope === 'user'
+        ? 'each person'
+        : ACTOR_LABEL[actor];
+}
+const KIND_TITLE = {
+    experience: 'Experiences',
+    integration: 'Integrations',
 };
 function catalogSummary(ui, catalog) {
-    const blocks = ['enabled', 'turned-off', 'available']
-        .map((availability) => {
-        const products = catalog.products.filter((product) => product.availability === availability);
-        if (products.length === 0)
-            return null;
+    // The same split as `ekanos sources products`: Experiences, then Integrations.
+    const blocks = ['experience', 'integration'].map((kind) => {
+        const products = catalog.products.filter((product) => product.kind === kind);
         return ui.result({
-            title: `${AVAILABILITY_LABEL[availability]} (${products.length})`,
-            tone: availability === 'enabled' ? 'ok' : 'warn',
+            title: `${KIND_TITLE[kind]} on ${catalog.source.slug} (${products.length})`,
+            tone: 'ok',
             rows: products.map((product) => [
                 product.slug,
-                [product.name, describeShape(product), openSteps(product)]
+                [
+                    SHORT_STATUS[product.availability],
+                    product.name,
+                    describeShape(product),
+                    nextStep(product),
+                ]
                     .filter(Boolean)
                     .join(' · '),
             ]),
         });
-    })
-        .filter((block) => block !== null);
+    });
+    const unregistered = catalog.products.filter((product) => product.registered === false).length;
     return [
         ...blocks,
-        ui.hint(`${pluralize(catalog.products.length, 'product')} on ${catalog.source.slug}. ` +
-            `"ekanos catalog <product>" shows tools, agent events and setup steps.`),
+        ui.hint(`${pluralize(catalog.products.length, 'product')} on ${catalog.source.slug}` +
+            (unregistered > 0
+                ? `, ${unregistered} with no package on this host (listed so this matches "ekanos sources products"; nothing here can use them)`
+                : '') +
+            `. "ekanos catalog <product>" shows tools with their inputs, whose connection agent runs use, agent events and setup steps.`),
     ].join('\n\n');
 }
 function productDetail(ui, product) {
@@ -75,16 +105,31 @@ function productDetail(ui, product) {
             'Kind',
             product.kind === 'experience' ? 'Ekanos Experience' : 'Integration',
         ],
-        ['Status', AVAILABILITY_LABEL[product.availability]],
+        [
+            'Status',
+            [STATUS_LABEL[product.availability], enableNeeds(product)]
+                .filter(Boolean)
+                .join(' — '),
+        ],
     ];
+    if (product.registered === false) {
+        rows.push([
+            'Package',
+            'None on this host — nothing here can use it until a build that ships it is deployed.',
+        ]);
+    }
+    if (product.connection) {
+        rows.push(['Connections', describeConnection(product.connection)]);
+    }
     if (product.connectedTeams !== null) {
         rows.push(['Teams connected', String(product.connectedTeams)]);
     }
+    if (product.connectedPeople !== null &&
+        product.connectedPeople !== undefined) {
+        rows.push(['People connected', String(product.connectedPeople)]);
+    }
     if (product.tools.length > 0) {
-        rows.push([
-            'Tools',
-            product.tools.map((tool) => `${tool.name} (${tool.effect}${tool.sensitivity === 'undeclared' ? '' : `, ${tool.sensitivity}`})`),
-        ]);
+        rows.push(['Tools', product.tools.flatMap(describeTool)]);
     }
     if (product.agentEvents.length > 0) {
         rows.push([
@@ -95,18 +140,22 @@ function productDetail(ui, product) {
     if (product.agentReplyTool) {
         rows.push(['Replies with', product.agentReplyTool]);
     }
-    rows.push([
-        'Setup',
-        product.setupSteps.flatMap((step, index) => { var _a; return [
-            `${index + 1}. [${step.state}] ${step.title} (${step.actor}) — ${step.detail}` +
-                (step.guideUrl ? ` ${step.guideUrl}` : ''),
-            ...(step.consoleUrl ? [`   Open ${step.consoleUrl}`] : []),
-            ...((_a = step.instructions) !== null && _a !== void 0 ? _a : []).map((line, lineIndex) => `   ${String.fromCharCode(97 + lineIndex)}. ${line}`),
-        ]; }),
-    ]);
+    if (product.setupSteps.length > 0) {
+        rows.push([
+            'Setup',
+            product.setupSteps.flatMap((step, index) => { var _a; return [
+                `${index + 1}. [${step.state}] ${step.title} (${actorLabel(step.actor, product)}) — ${step.detail}` +
+                    (step.guideUrl ? ` ${step.guideUrl}` : ''),
+                ...(step.consoleUrl ? [`   Open ${step.consoleUrl}`] : []),
+                ...((_a = step.instructions) !== null && _a !== void 0 ? _a : []).map((line, lineIndex) => `   ${String.fromCharCode(97 + lineIndex)}. ${line}`),
+            ]; }),
+        ]);
+    }
     return ui.result({ title: `${product.name} (${product.slug})`, rows });
 }
 function describeShape(product) {
+    if (product.registered === false)
+        return 'no package on this host';
     const parts = [
         product.tools.length > 0 ? pluralize(product.tools.length, 'tool') : null,
         product.agentEvents.length > 0
@@ -115,8 +164,90 @@ function describeShape(product) {
     ].filter(Boolean);
     return parts.join(', ');
 }
-function openSteps(product) {
+/**
+ * What stands between the Source and using it. A product only Vastly can
+ * enable says so instead of counting steps nobody on the Source can take.
+ */
+function nextStep(product) {
+    if (product.registered === false)
+        return '';
+    const needs = enableNeeds(product);
+    if (needs)
+        return needs;
     const open = product.setupSteps.filter((step) => step.state === 'todo');
-    return open.length === 0 ? '' : `${pluralize(open.length, 'step')} left`;
+    const ours = open.filter((step) => step.actor !== 'ekanos');
+    return [
+        ours.length > 0 ? `${pluralize(ours.length, 'step')} left` : null,
+        ours.length < open.length ? 'waiting on Vastly' : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+}
+/** Who has to enable a product that is not enabled, or null when it is. */
+function enableNeeds(product) {
+    if (product.availability === 'enabled')
+        return null;
+    if (product.availability === 'turned-off') {
+        return 'needs Vastly to switch it on';
+    }
+    return product.owned
+        ? `built by this Source — its Source admin enables it ("ekanos sources products enable ${product.slug}")`
+        : 'needs a Vastly grant';
+}
+/**
+ * Whose connection a product's calls use: the team's, each person's own (on a
+ * team or provided agent, the creator's, lent to whoever the run acts for),
+ * or the Source's, when a Source admin connected it once for every team.
+ */
+function describeConnection(connection) {
+    const lines = [];
+    switch (connection.connectedBy) {
+        case 'nobody':
+            return ['Nothing to connect — it works as shipped.'];
+        case 'team':
+            lines.push("Each team connects its own. An agent run uses its team's connection.");
+            break;
+        case 'person':
+            lines.push("Each person connects their own. An agent run uses its creator's own connection — on a personal agent that is the person it runs for, including its schedule and webhook runs; on a team or provided agent it is lent to whoever the run acts for.");
+            break;
+    }
+    if (connection.sourceConnection !== 'unsupported') {
+        lines.push(`A Source admin can connect it once for every team ("ekanos apps connect"): a provided agent whose template marks it Source-owned then uses the Source's connection, limited to the team's routed records. ` +
+            (connection.sourceConnection === 'connected'
+                ? 'This Source has.'
+                : 'This Source has not yet.'));
+    }
+    return lines;
+}
+/**
+ * A tool, then its inputs one per line from its JSON schema — what an agent
+ * designer needs to see which other tool supplies an id.
+ */
+function describeTool(tool) {
+    const head = `${tool.name} (${tool.effect}${tool.sensitivity === 'undeclared' ? '' : `, ${tool.sensitivity}`})` +
+        (tool.description ? ` — ${tool.description}` : '');
+    if (!tool.inputSchema)
+        return [head];
+    const properties = asRecord(tool.inputSchema.properties);
+    const required = new Set(Array.isArray(tool.inputSchema.required)
+        ? tool.inputSchema.required.filter((key) => typeof key === 'string')
+        : []);
+    const inputs = Object.entries(properties).map(([key, value]) => {
+        const property = asRecord(value);
+        const type = typeof property.type === 'string' ? property.type : null;
+        const description = typeof property.description === 'string' ? property.description : null;
+        return (`   ${key}` +
+            [type, required.has(key) ? 'required' : null]
+                .filter(Boolean)
+                .map((part, index) => (index === 0 ? `: ${part}` : `, ${part}`))
+                .join('') +
+            (description ? ` — ${description}` : ''));
+    });
+    return [head, ...(inputs.length > 0 ? inputs : ['   no inputs'])];
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : {};
 }
 //# sourceMappingURL=catalog.js.map

package/dist/commands/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/commands/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CatalogProduct, SourceCatalog } from '@ekanos/integration-schema';\n\nimport { loginHint } from '../auth/host-trust';\nimport {\n  type AuthEnvironment,\n  refreshStoredSession,\n  requireSession,\n  resolveAuthEnvironment,\n} from '../auth/session';\nimport {\n  type FetchSourceCatalogResult,\n  fetchSourceCatalog,\n} from '../catalog-api';\nimport type { CliContext } from '../context';\nimport { authRequiredError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { resolveSourceTarget } from '../source-target';\nimport { type Ui, pluralize } from '../ui';\nimport { withDocsHint } from './agents-init';\n\nexport interface CatalogArgs {\n  host?: string;\n  source?: string;\n  /** One product's detail, when given. */\n  product?: string;\n  dir: string;\n  env: Record<string, string | undefined>;\n}\n\n/**\n * `catalog` — what the Source can already do (plan 239.0). Lists every\n * product the Source can use, with its tools, agent events and the steps\n * left to set it up; `ekanos catalog <product>` shows one in full.\n *\n * Read before building: an agent migration asks it first, so a capability\n * the Source already has is set up rather than rebuilt. Works outside a\n * project — the Source comes from `--source`, else `ekanos.json`, else the\n * caller's only seat.\n */\nexport async function runCatalog(\n  ctx: CliContext,\n  args: CatalogArgs,\n): Promise<ExitCode> {\n  const env = resolveAuthEnvironment(ctx, args.host, args.env, {\n    projectDir: args.dir,\n  });\n  let session = requireSession(env);\n\n  const resolved = await resolveSourceTarget(env, session, args);\n  session = resolved.session;\n\n  const query = { source: resolved.source, product: args.product };\n  let result = await fetchSourceCatalog(env.host, session.accessToken, query);\n  if (result.status === 'unauthorized') {\n    session = await refreshStoredSession(env, session);\n    result = await fetchSourceCatalog(env.host, session.accessToken, query);\n  }\n  const catalog = requireCatalog(result, env);\n\n  return ctx.succeed(\n    { host: env.host, ...catalog },\n    withDocsHint(\n      ctx.ui,\n      args.dir,\n      args.product\n        ? productDetail(ctx.ui, catalog.products[0]!)\n        : catalogSummary(ctx.ui, catalog),\n    ),\n  );\n}\n\nfunction requireCatalog(\n  result: FetchSourceCatalogResult,\n  env: AuthEnvironment,\n): SourceCatalog {\n  if (result.status === 'ok') return result.catalog;\n  throw authRequiredError(\n    `The session for ${env.host} could not authorize the catalog read.`,\n    loginHint(env),\n  );\n}\n\nconst AVAILABILITY_LABEL = {\n  enabled: 'Enabled on this Source',\n  'turned-off': 'Not enabled — granted, but switched off',\n  available: 'Not enabled — only a super-admin enables it',\n} as const;\n\nfunction catalogSummary(ui: Ui, catalog: SourceCatalog): string {\n  const blocks = (['enabled', 'turned-off', 'available'] as const)\n    .map((availability) => {\n      const products = catalog.products.filter(\n        (product) => product.availability === availability,\n      );\n      if (products.length === 0) return null;\n      return ui.result({\n        title: `${AVAILABILITY_LABEL[availability]} (${products.length})`,\n        tone: availability === 'enabled' ? 'ok' : 'warn',\n        rows: products.map((product): [string, string] => [\n          product.slug,\n          [product.name, describeShape(product), openSteps(product)]\n            .filter(Boolean)\n            .join(' · '),\n        ]),\n      });\n    })\n    .filter((block): block is string => block !== null);\n\n  return [\n    ...blocks,\n    ui.hint(\n      `${pluralize(catalog.products.length, 'product')} on ${catalog.source.slug}. ` +\n        `\"ekanos catalog <product>\" shows tools, agent events and setup steps.`,\n    ),\n  ].join('\\n\\n');\n}\n\nfunction productDetail(ui: Ui, product: CatalogProduct): string {\n  const rows: [string, string | string[]][] = [\n    ['What', product.summary ?? '—'],\n    [\n      'Kind',\n      product.kind === 'experience' ? 'Ekanos Experience' : 'Integration',\n    ],\n    ['Status', AVAILABILITY_LABEL[product.availability]],\n  ];\n  if (product.connectedTeams !== null) {\n    rows.push(['Teams connected', String(product.connectedTeams)]);\n  }\n  if (product.tools.length > 0) {\n    rows.push([\n      'Tools',\n      product.tools.map(\n        (tool) =>\n          `${tool.name} (${tool.effect}${tool.sensitivity === 'undeclared' ? '' : `, ${tool.sensitivity}`})`,\n      ),\n    ]);\n  }\n  if (product.agentEvents.length > 0) {\n    rows.push([\n      'Agent triggers',\n      product.agentEvents.map((event) => `${event.id} — ${event.label}`),\n    ]);\n  }\n  if (product.agentReplyTool) {\n    rows.push(['Replies with', product.agentReplyTool]);\n  }\n  rows.push([\n    'Setup',\n    product.setupSteps.flatMap((step, index) => [\n      `${index + 1}. [${step.state}] ${step.title} (${step.actor}) — ${step.detail}` +\n        (step.guideUrl ? ` ${step.guideUrl}` : ''),\n      ...(step.consoleUrl ? [`   Open ${step.consoleUrl}`] : []),\n      ...(step.instructions ?? []).map(\n        (line, lineIndex) =>\n          `   ${String.fromCharCode(97 + lineIndex)}. ${line}`,\n      ),\n    ]),\n  ]);\n\n  return ui.result({ title: `${product.name} (${product.slug})`, rows });\n}\n\nfunction describeShape(product: CatalogProduct): string {\n  const parts = [\n    product.tools.length > 0 ? pluralize(product.tools.length, 'tool') : null,\n    product.agentEvents.length > 0\n      ? pluralize(product.agentEvents.length, 'agent trigger')\n      : null,\n  ].filter(Boolean);\n  return parts.join(', ');\n}\n\nfunction openSteps(product: CatalogProduct): string {\n  const open = product.setupSteps.filter((step) => step.state === 'todo');\n  return open.length === 0 ? '' : `${pluralize(open.length, 'step')} left`;\n}\n"]}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/commands/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CatalogConnection,\n  CatalogProduct,\n  CatalogSetupStep,\n  CatalogTool,\n  SourceCatalog,\n} from '@ekanos/integration-schema';\n\nimport { loginHint } from '../auth/host-trust';\nimport {\n  type AuthEnvironment,\n  refreshStoredSession,\n  requireSession,\n  resolveAuthEnvironment,\n} from '../auth/session';\nimport {\n  type FetchSourceCatalogResult,\n  fetchSourceCatalog,\n} from '../catalog-api';\nimport type { CliContext } from '../context';\nimport { authRequiredError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { resolveSourceTarget } from '../source-target';\nimport { type Ui, pluralize } from '../ui';\nimport { withDocsHint } from './agents-init';\n\nexport interface CatalogArgs {\n  host?: string;\n  source?: string;\n  /** One product's detail, when given. */\n  product?: string;\n  dir: string;\n  env: Record<string, string | undefined>;\n}\n\n/**\n * `catalog` — what the Source can already do (plan 239.0). Lists every\n * product the Source can use, Experiences then Integrations as `ekanos\n * sources products` splits them, with its tools, agent events and the steps\n * left to set it up; `ekanos catalog <product>` shows one in full, with each\n * tool's inputs and whose connection an agent run uses.\n *\n * Read before building: an agent migration asks it first, so a capability\n * the Source already has is set up rather than rebuilt. Works outside a\n * project — the Source comes from `--source`, else `ekanos.json`, else the\n * caller's only seat.\n */\nexport async function runCatalog(\n  ctx: CliContext,\n  args: CatalogArgs,\n): Promise<ExitCode> {\n  const env = resolveAuthEnvironment(ctx, args.host, args.env, {\n    projectDir: args.dir,\n  });\n  let session = requireSession(env);\n\n  const resolved = await resolveSourceTarget(env, session, args);\n  session = resolved.session;\n\n  const query = { source: resolved.source, product: args.product };\n  let result = await fetchSourceCatalog(env.host, session.accessToken, query);\n  if (result.status === 'unauthorized') {\n    session = await refreshStoredSession(env, session);\n    result = await fetchSourceCatalog(env.host, session.accessToken, query);\n  }\n  const catalog = requireCatalog(result, env);\n\n  // The agent-design tip belongs on the overview only, not every product.\n  return ctx.succeed(\n    { host: env.host, ...catalog },\n    args.product\n      ? productDetail(ctx.ui, catalog.products[0]!)\n      : withDocsHint(ctx.ui, args.dir, catalogSummary(ctx.ui, catalog)),\n  );\n}\n\nfunction requireCatalog(\n  result: FetchSourceCatalogResult,\n  env: AuthEnvironment,\n): SourceCatalog {\n  if (result.status === 'ok') return result.catalog;\n  throw authRequiredError(\n    `The session for ${env.host} could not authorize the catalog read.`,\n    loginHint(env),\n  );\n}\n\nconst STATUS_LABEL = {\n  enabled: 'Enabled on this Source',\n  'turned-off': 'Not enabled — granted, but a Flag or plan switches it off',\n  available: 'Not enabled',\n} as const;\n\nconst SHORT_STATUS = {\n  enabled: '✓ enabled',\n  'turned-off': '✗ switched off',\n  available: '✗ not enabled',\n} as const;\n\n/** Who does a setup step, in words. The wire value `ekanos` is Vastly. */\nconst ACTOR_LABEL = {\n  ekanos: 'Vastly',\n  source_admin: 'Source admin',\n  team: 'team',\n} as const;\n\n/** A `team` step on a per-person product is each person's to do. */\nfunction actorLabel(\n  actor: CatalogSetupStep['actor'],\n  product: CatalogProduct,\n): string {\n  return actor === 'team' && product.scope === 'user'\n    ? 'each person'\n    : ACTOR_LABEL[actor];\n}\n\nconst KIND_TITLE = {\n  experience: 'Experiences',\n  integration: 'Integrations',\n} as const;\n\nfunction catalogSummary(ui: Ui, catalog: SourceCatalog): string {\n  // The same split as `ekanos sources products`: Experiences, then Integrations.\n  const blocks = (['experience', 'integration'] as const).map((kind) => {\n    const products = catalog.products.filter(\n      (product) => product.kind === kind,\n    );\n    return ui.result({\n      title: `${KIND_TITLE[kind]} on ${catalog.source.slug} (${products.length})`,\n      tone: 'ok',\n      rows: products.map((product): [string, string] => [\n        product.slug,\n        [\n          SHORT_STATUS[product.availability],\n          product.name,\n          describeShape(product),\n          nextStep(product),\n        ]\n          .filter(Boolean)\n          .join(' · '),\n      ]),\n    });\n  });\n\n  const unregistered = catalog.products.filter(\n    (product) => product.registered === false,\n  ).length;\n  return [\n    ...blocks,\n    ui.hint(\n      `${pluralize(catalog.products.length, 'product')} on ${catalog.source.slug}` +\n        (unregistered > 0\n          ? `, ${unregistered} with no package on this host (listed so this matches \"ekanos sources products\"; nothing here can use them)`\n          : '') +\n        `. \"ekanos catalog <product>\" shows tools with their inputs, whose connection agent runs use, agent events and setup steps.`,\n    ),\n  ].join('\\n\\n');\n}\n\nfunction productDetail(ui: Ui, product: CatalogProduct): string {\n  const rows: [string, string | string[]][] = [\n    ['What', product.summary ?? '—'],\n    [\n      'Kind',\n      product.kind === 'experience' ? 'Ekanos Experience' : 'Integration',\n    ],\n    [\n      'Status',\n      [STATUS_LABEL[product.availability], enableNeeds(product)]\n        .filter(Boolean)\n        .join(' — '),\n    ],\n  ];\n  if (product.registered === false) {\n    rows.push([\n      'Package',\n      'None on this host — nothing here can use it until a build that ships it is deployed.',\n    ]);\n  }\n  if (product.connection) {\n    rows.push(['Connections', describeConnection(product.connection)]);\n  }\n  if (product.connectedTeams !== null) {\n    rows.push(['Teams connected', String(product.connectedTeams)]);\n  }\n  if (\n    product.connectedPeople !== null &&\n    product.connectedPeople !== undefined\n  ) {\n    rows.push(['People connected', String(product.connectedPeople)]);\n  }\n  if (product.tools.length > 0) {\n    rows.push(['Tools', product.tools.flatMap(describeTool)]);\n  }\n  if (product.agentEvents.length > 0) {\n    rows.push([\n      'Agent triggers',\n      product.agentEvents.map((event) => `${event.id} — ${event.label}`),\n    ]);\n  }\n  if (product.agentReplyTool) {\n    rows.push(['Replies with', product.agentReplyTool]);\n  }\n  if (product.setupSteps.length > 0) {\n    rows.push([\n      'Setup',\n      product.setupSteps.flatMap((step, index) => [\n        `${index + 1}. [${step.state}] ${step.title} (${actorLabel(step.actor, product)}) — ${step.detail}` +\n          (step.guideUrl ? ` ${step.guideUrl}` : ''),\n        ...(step.consoleUrl ? [`   Open ${step.consoleUrl}`] : []),\n        ...(step.instructions ?? []).map(\n          (line, lineIndex) =>\n            `   ${String.fromCharCode(97 + lineIndex)}. ${line}`,\n        ),\n      ]),\n    ]);\n  }\n\n  return ui.result({ title: `${product.name} (${product.slug})`, rows });\n}\n\nfunction describeShape(product: CatalogProduct): string {\n  if (product.registered === false) return 'no package on this host';\n  const parts = [\n    product.tools.length > 0 ? pluralize(product.tools.length, 'tool') : null,\n    product.agentEvents.length > 0\n      ? pluralize(product.agentEvents.length, 'agent trigger')\n      : null,\n  ].filter(Boolean);\n  return parts.join(', ');\n}\n\n/**\n * What stands between the Source and using it. A product only Vastly can\n * enable says so instead of counting steps nobody on the Source can take.\n */\nfunction nextStep(product: CatalogProduct): string {\n  if (product.registered === false) return '';\n  const needs = enableNeeds(product);\n  if (needs) return needs;\n\n  const open = product.setupSteps.filter((step) => step.state === 'todo');\n  const ours = open.filter((step) => step.actor !== 'ekanos');\n  return [\n    ours.length > 0 ? `${pluralize(ours.length, 'step')} left` : null,\n    ours.length < open.length ? 'waiting on Vastly' : null,\n  ]\n    .filter(Boolean)\n    .join(', ');\n}\n\n/** Who has to enable a product that is not enabled, or null when it is. */\nfunction enableNeeds(product: CatalogProduct): string | null {\n  if (product.availability === 'enabled') return null;\n  if (product.availability === 'turned-off') {\n    return 'needs Vastly to switch it on';\n  }\n  return product.owned\n    ? `built by this Source — its Source admin enables it (\"ekanos sources products enable ${product.slug}\")`\n    : 'needs a Vastly grant';\n}\n\n/**\n * Whose connection a product's calls use: the team's, each person's own (on a\n * team or provided agent, the creator's, lent to whoever the run acts for),\n * or the Source's, when a Source admin connected it once for every team.\n */\nfunction describeConnection(connection: CatalogConnection): string[] {\n  const lines: string[] = [];\n  switch (connection.connectedBy) {\n    case 'nobody':\n      return ['Nothing to connect — it works as shipped.'];\n    case 'team':\n      lines.push(\n        \"Each team connects its own. An agent run uses its team's connection.\",\n      );\n      break;\n    case 'person':\n      lines.push(\n        \"Each person connects their own. An agent run uses its creator's own connection — on a personal agent that is the person it runs for, including its schedule and webhook runs; on a team or provided agent it is lent to whoever the run acts for.\",\n      );\n      break;\n  }\n  if (connection.sourceConnection !== 'unsupported') {\n    lines.push(\n      `A Source admin can connect it once for every team (\"ekanos apps connect\"): a provided agent whose template marks it Source-owned then uses the Source's connection, limited to the team's routed records. ` +\n        (connection.sourceConnection === 'connected'\n          ? 'This Source has.'\n          : 'This Source has not yet.'),\n    );\n  }\n  return lines;\n}\n\n/**\n * A tool, then its inputs one per line from its JSON schema — what an agent\n * designer needs to see which other tool supplies an id.\n */\nfunction describeTool(tool: CatalogTool): string[] {\n  const head =\n    `${tool.name} (${tool.effect}${tool.sensitivity === 'undeclared' ? '' : `, ${tool.sensitivity}`})` +\n    (tool.description ? ` — ${tool.description}` : '');\n  if (!tool.inputSchema) return [head];\n\n  const properties = asRecord(tool.inputSchema.properties);\n  const required = new Set(\n    Array.isArray(tool.inputSchema.required)\n      ? tool.inputSchema.required.filter(\n          (key): key is string => typeof key === 'string',\n        )\n      : [],\n  );\n  const inputs = Object.entries(properties).map(([key, value]) => {\n    const property = asRecord(value);\n    const type = typeof property.type === 'string' ? property.type : null;\n    const description =\n      typeof property.description === 'string' ? property.description : null;\n    return (\n      `   ${key}` +\n      [type, required.has(key) ? 'required' : null]\n        .filter(Boolean)\n        .map((part, index) => (index === 0 ? `: ${part}` : `, ${part}`))\n        .join('') +\n      (description ? ` — ${description}` : '')\n    );\n  });\n  return [head, ...(inputs.length > 0 ? inputs : ['   no inputs'])];\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n"]}

package/dist/commands/check.d.ts

@@ -0,0 +1,2 @@
+import type { ExperienceCommand } from './index-experience.js';
+export declare const checkCommand: ExperienceCommand;

package/dist/commands/check.js

@@ -0,0 +1,43 @@
+import { harnessPinsResolver } from '../dev-experience.js';
+import { runExperienceChecks } from '../experience/checks.js';
+import { readExperienceProject } from '../experience/project.js';
+import { failOnErrors } from '../experience/report.js';
+export const checkCommand = {
+    name: 'check',
+    usage: [
+        '  check      Run the experience gate: integration pins, generated types, integration-',
+        '             import boundary (source + bundle), fixtures, definition, typecheck',
+    ],
+    specs: {
+        dir: {
+            type: 'string',
+            description: 'Project directory (default: the current one)',
+        },
+        typecheck: {
+            type: 'boolean',
+            default: true,
+            description: 'Run tsc over the project (--no-typecheck skips)',
+        },
+    },
+    async run(ctx, args) {
+        const project = readExperienceProject(args.dir);
+        const result = await runExperienceChecks(project, {
+            typecheck: args.flags.typecheck !== false,
+            loadDefinition: true,
+            inlineSdk: args.env.EKANOS_INLINE_SDK,
+            pinsResolver: await harnessPinsResolver(project.dir, args.env),
+        });
+        const failed = failOnErrors(ctx, 'check', result.findings, {
+            slug: project.slug,
+            integrations: project.integrations.map((u) => u.name),
+        }, project.dir);
+        if (failed !== null)
+            return failed;
+        return ctx.succeed({
+            slug: project.slug,
+            integrations: project.integrations.map((u) => u.name),
+            findings: result.findings,
+        }, `check: OK - ${project.slug} (${project.integrations.length} integration${project.integrations.length === 1 ? '' : 's'})${result.findings.length ? `, ${result.findings.length} warning${result.findings.length === 1 ? '' : 's'}` : ''}.`);
+    },
+};
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACL,uFAAuF;QACvF,iFAAiF;KAClF;IACD,KAAK,EAAE;QACL,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8CAA8C;SAC5D;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,iDAAiD;SAC/D;KACF;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI;QACjB,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE;YAChD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK;YACzC,cAAc,EAAE,IAAI;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB;YACrC,YAAY,EAAE,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;SAC/D,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,YAAY,CACzB,GAAG,EACH,OAAO,EACP,MAAM,CAAC,QAAQ,EACf;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACtD,EACD,OAAO,CAAC,GAAG,CACZ,CAAC;QACF,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnC,OAAO,GAAG,CAAC,OAAO,CAChB;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,EACD,eAAe,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,MAAM,eAAe,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,WAAW,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAC3O,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["import { harnessPinsResolver } from '../dev-experience';\nimport { runExperienceChecks } from '../experience/checks';\nimport { readExperienceProject } from '../experience/project';\nimport { failOnErrors } from '../experience/report';\nimport type { ExperienceCommand } from './index-experience';\n\nexport const checkCommand: ExperienceCommand = {\n  name: 'check',\n  usage: [\n    '  check      Run the experience gate: integration pins, generated types, integration-',\n    '             import boundary (source + bundle), fixtures, definition, typecheck',\n  ],\n  specs: {\n    dir: {\n      type: 'string',\n      description: 'Project directory (default: the current one)',\n    },\n    typecheck: {\n      type: 'boolean',\n      default: true,\n      description: 'Run tsc over the project (--no-typecheck skips)',\n    },\n  },\n  async run(ctx, args) {\n    const project = readExperienceProject(args.dir);\n    const result = await runExperienceChecks(project, {\n      typecheck: args.flags.typecheck !== false,\n      loadDefinition: true,\n      inlineSdk: args.env.EKANOS_INLINE_SDK,\n      pinsResolver: await harnessPinsResolver(project.dir, args.env),\n    });\n\n    const failed = failOnErrors(\n      ctx,\n      'check',\n      result.findings,\n      {\n        slug: project.slug,\n        integrations: project.integrations.map((u) => u.name),\n      },\n      project.dir,\n    );\n    if (failed !== null) return failed;\n\n    return ctx.succeed(\n      {\n        slug: project.slug,\n        integrations: project.integrations.map((u) => u.name),\n        findings: result.findings,\n      },\n      `check: OK - ${project.slug} (${project.integrations.length} integration${project.integrations.length === 1 ? '' : 's'})${result.findings.length ? `, ${result.findings.length} warning${result.findings.length === 1 ? '' : 's'}` : ''}.`,\n    );\n  },\n};\n"]}

package/dist/commands/codegen.d.ts

@@ -0,0 +1,2 @@
+import type { ExperienceCommand } from './index-experience.js';
+export declare const codegenCommand: ExperienceCommand;

package/dist/commands/codegen.js

@@ -0,0 +1,49 @@
+import { preconditionError, validationError } from '../errors.js';
+import { expectedIntegrationsDts } from '../experience/checks.js';
+import { readExperienceProject } from '../experience/project.js';
+import { loadPins, regenerateIntegrations } from '../experience/regenerate.js';
+export const codegenCommand = {
+    name: 'codegen',
+    usage: [
+        '  codegen    Regenerate src/.ekanos/integrations.d.ts from the pinned contracts',
+        '             (offline, idempotent; --check fails when it is stale)',
+    ],
+    specs: {
+        dir: {
+            type: 'string',
+            description: 'Project directory (default: the current one)',
+        },
+        check: {
+            type: 'boolean',
+            description: 'Fail when the committed file differs; write nothing',
+        },
+    },
+    async run(ctx, args) {
+        const project = readExperienceProject(args.dir);
+        const { pinned, missing } = loadPins(project);
+        if (missing.length > 0) {
+            throw preconditionError(`No pinned contract for integration${missing.length === 1 ? '' : 's'}: ${missing.join(', ')}.`, 'Run "ekanos add <integration>@<version> --from-dir <contracts folder>" or "ekanos sync" first.');
+        }
+        if (args.flags.check === true) {
+            const fs = await import('node:fs');
+            const path = await import('node:path');
+            const file = path.join(project.dir, 'src/.ekanos/integrations.d.ts');
+            const current = fs.existsSync(file)
+                ? fs.readFileSync(file, 'utf8')
+                : null;
+            if (current !== expectedIntegrationsDts(pinned)) {
+                throw validationError('src/.ekanos/integrations.d.ts is stale.', 'Run "ekanos codegen" and commit the result.');
+            }
+            return ctx.succeed({ changed: false, integrations: pinned.length }, 'integrations.d.ts is up to date.');
+        }
+        const changed = regenerateIntegrations(project, pinned);
+        return ctx.succeed({
+            changed,
+            integrations: pinned.length,
+            file: 'src/.ekanos/integrations.d.ts',
+        }, changed
+            ? `Wrote src/.ekanos/integrations.d.ts (${pinned.length} integration${pinned.length === 1 ? '' : 's'}).`
+            : 'integrations.d.ts is already up to date.');
+    },
+};
+//# sourceMappingURL=codegen.js.map

package/dist/commands/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/commands/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAG5E,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE;QACL,iFAAiF;QACjF,oEAAoE;KACrE;IACD,KAAK,EAAE;QACL,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8CAA8C;SAC5D;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,qDAAqD;SACnE;KACF;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI;QACjB,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,iBAAiB,CACrB,qCAAqC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC9F,gGAAgG,CACjG,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,OAAO,KAAK,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,MAAM,eAAe,CACnB,yCAAyC,EACzC,6CAA6C,CAC9C,CAAC;YACJ,CAAC;YAED,OAAO,GAAG,CAAC,OAAO,CAChB,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,EAC/C,kCAAkC,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAExD,OAAO,GAAG,CAAC,OAAO,CAChB;YACE,OAAO;YACP,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,IAAI,EAAE,+BAA+B;SACtC,EACD,OAAO;YACL,CAAC,CAAC,wCAAwC,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;YACxG,CAAC,CAAC,0CAA0C,CAC/C,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["import { preconditionError, validationError } from '../errors';\nimport { expectedIntegrationsDts } from '../experience/checks';\nimport { readExperienceProject } from '../experience/project';\nimport { loadPins, regenerateIntegrations } from '../experience/regenerate';\nimport type { ExperienceCommand } from './index-experience';\n\nexport const codegenCommand: ExperienceCommand = {\n  name: 'codegen',\n  usage: [\n    '  codegen    Regenerate src/.ekanos/integrations.d.ts from the pinned contracts',\n    '             (offline, idempotent; --check fails when it is stale)',\n  ],\n  specs: {\n    dir: {\n      type: 'string',\n      description: 'Project directory (default: the current one)',\n    },\n    check: {\n      type: 'boolean',\n      description: 'Fail when the committed file differs; write nothing',\n    },\n  },\n  async run(ctx, args) {\n    const project = readExperienceProject(args.dir);\n    const { pinned, missing } = loadPins(project);\n    if (missing.length > 0) {\n      throw preconditionError(\n        `No pinned contract for integration${missing.length === 1 ? '' : 's'}: ${missing.join(', ')}.`,\n        'Run \"ekanos add <integration>@<version> --from-dir <contracts folder>\" or \"ekanos sync\" first.',\n      );\n    }\n\n    if (args.flags.check === true) {\n      const fs = await import('node:fs');\n      const path = await import('node:path');\n      const file = path.join(project.dir, 'src/.ekanos/integrations.d.ts');\n      const current = fs.existsSync(file)\n        ? fs.readFileSync(file, 'utf8')\n        : null;\n      if (current !== expectedIntegrationsDts(pinned)) {\n        throw validationError(\n          'src/.ekanos/integrations.d.ts is stale.',\n          'Run \"ekanos codegen\" and commit the result.',\n        );\n      }\n\n      return ctx.succeed(\n        { changed: false, integrations: pinned.length },\n        'integrations.d.ts is up to date.',\n      );\n    }\n\n    const changed = regenerateIntegrations(project, pinned);\n\n    return ctx.succeed(\n      {\n        changed,\n        integrations: pinned.length,\n        file: 'src/.ekanos/integrations.d.ts',\n      },\n      changed\n        ? `Wrote src/.ekanos/integrations.d.ts (${pinned.length} integration${pinned.length === 1 ? '' : 's'}).`\n        : 'integrations.d.ts is already up to date.',\n    );\n  },\n};\n"]}

package/dist/commands/contract.d.ts

@@ -0,0 +1,52 @@
+import { type Contract } from '@ekanos/integration-schema';
+import type { CliContext } from '../context.js';
+import { type HarnessResolver } from '../dev-experience.js';
+import type { ExitCode } from '../exit-codes.js';
+import type { ExperienceCommand } from './index-experience.js';
+/** The slice of `@ekanos/sdk/contract` this command uses. */
+export interface ContractModule {
+    analyzeContract(definition: unknown, options: {
+        packageVersion: string;
+        contractVersion: string;
+        previous?: Contract | null;
+        examples?: Readonly<Record<string, unknown>>;
+    }): {
+        contract: Contract;
+        diagnostics: Array<{
+            rule: string;
+            severity: 'error' | 'warn' | 'info';
+            message: string;
+            operation?: string;
+        }>;
+    };
+    synthesizeExample(schema: unknown): unknown;
+}
+export interface ContractArgs {
+    dir: string;
+    check: boolean;
+    record: boolean;
+    bump: boolean;
+    env?: Record<string, string | undefined>;
+    /**
+     * `--record --op tool/x[,action/y]`: record REAL examples for these
+     * operations from a run through the harness runner, instead of writing
+     * placeholders.
+     */
+    ops?: string[];
+    /** Which run mode produces the example (default `fixtures`). */
+    from?: 'fixtures' | 'live';
+    /** JSON input for the recorded run (single `--op` only); default: synthesized from the input schema. */
+    input?: string;
+    /** Test seam; the default loads the project's installed `@ekanos/harness/resolver`. */
+    loadHarness?: (projectDir: string) => Promise<HarnessResolver>;
+    /** Test seam; the default loads `@ekanos/sdk/contract` from the project. */
+    loadModule?: (projectDir: string) => Promise<ContractModule>;
+}
+/** The smallest contractVersion that satisfies the transition rules. */
+export declare function nextContractVersion(previous: Contract, next: Contract): string | null;
+/**
+ * `ekanos contract`: derive `contract.json` from the integration definition.
+ * See the command's usage text for the three modes.
+ */
+export declare function runContract(ctx: CliContext, args: ContractArgs): Promise<ExitCode>;
+export declare const contractCommand: ExperienceCommand;