@frontera-sdk/cli 1.49.0 → 1.50.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/cli",
-  "version": "1.49.0",
+  "version": "1.50.1",
   "description": "The frontera CLI — scaffold, pull, save and deploy Frontera apps and automations.",
   "keywords": [
     "frontera",
@@ -39,14 +39,14 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.251",
-    "@frontera-sdk/automation": "1.49.0",
-    "@frontera-sdk/core": "1.49.0",
+    "@frontera-sdk/functions": "1.50.1",
+    "@frontera-sdk/core": "1.50.1",
     "ai": "^6.0.116",
     "gray-matter": "^4.0.3",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@frontera-sdk/forge-contracts": "1.49.0",
+    "@frontera-sdk/forge-contracts": "1.50.1",
     "@types/bun": "^1.3.14",
     "typescript": "^5.9.3"
   }

package/src/api/automation-api.ts

@@ -3,7 +3,7 @@ import { FronteraError } from '@frontera-sdk/core/errors'
 
 import { CliError } from '../errors'
 
-/** A row of `GET /v1/automations/` — the shell, not any one version of it. */
+/** A row of `GET /v1/functions/` — the shell, not any one version of it. */
 export interface AutomationSummary {
   id: string
   slug: string
@@ -73,7 +73,7 @@ export interface AutomationDeployResult {
   runnerLastSeenAt?: string | null
 }
 
-/** A row of `GET /v1/automations/<slug>/runs`. */
+/** A row of `GET /v1/functions/<slug>/runs`. */
 export interface AutomationRunSummary {
   id: string
   status: string
@@ -103,7 +103,7 @@ export interface AutomationRunSummary {
   input?: Record<string, unknown> | null
 }
 
-/** A row of `GET /v1/automations/runs/<id>/steps`. */
+/** A row of `GET /v1/functions/runs/<id>/steps`. */
 export interface AutomationRunStep {
   id: string
   seq: number
@@ -127,7 +127,7 @@ export interface AutomationRunStep {
   detail?: Record<string, unknown>
 }
 
-/** `GET /v1/automations/registry-status`. */
+/** `GET /v1/functions/registry-status`. */
 export interface RegistryStatus {
   /** The generation the service has. */
   generation: number
@@ -174,18 +174,18 @@ export class AutomationApi {
   }
 
   list(): Promise<AutomationSummary[]> {
-    return this.client.request<AutomationSummary[]>('/v1/automations/')
+    return this.client.request<AutomationSummary[]>('/v1/functions/')
   }
 
   versions(slug: string): Promise<AutomationVersionSummary[]> {
     return this.client.request<AutomationVersionSummary[]>(
-      `/v1/automations/${encodeURIComponent(slug)}/versions`,
+      `/v1/functions/${encodeURIComponent(slug)}/versions`,
     )
   }
 
   promote(slug: string, version: number): Promise<{ slug: string; version: number }> {
     return this.client.request<{ slug: string; version: number }>(
-      `/v1/automations/${encodeURIComponent(slug)}/promote/${version}`,
+      `/v1/functions/${encodeURIComponent(slug)}/promote/${version}`,
       { method: 'POST' },
     )
   }
@@ -220,7 +220,7 @@ export class AutomationApi {
       : version === undefined && input === undefined
         ? undefined
         : { ...(version === undefined ? {} : { version }), ...(input === undefined ? {} : { input }) }
-    return this.client.request(`/v1/automations/${encodeURIComponent(slug)}/run`, {
+    return this.client.request(`/v1/functions/${encodeURIComponent(slug)}/run`, {
       method: 'POST',
       body,
     })
@@ -241,7 +241,7 @@ export class AutomationApi {
     leaseMs: number
   }> {
     return this.client.request(
-      `/v1/automations/${encodeURIComponent(slug)}/dev/session`,
+      `/v1/functions/${encodeURIComponent(slug)}/dev/session`,
       { method: 'POST', body: { entryFile, holderId } },
     )
   }
@@ -278,7 +278,7 @@ export class AutomationApi {
   }> {
     const q = `sessionId=${encodeURIComponent(sessionId)}&holderId=${encodeURIComponent(holderId)}`
     return this.client.request(
-      `/v1/automations/${encodeURIComponent(slug)}/dev/poll?${q}`,
+      `/v1/functions/${encodeURIComponent(slug)}/dev/poll?${q}`,
       { method: 'POST', body: { manifest } },
     )
   }
@@ -290,13 +290,13 @@ export class AutomationApi {
   ): Promise<{ closed: boolean }> {
     const q = `sessionId=${encodeURIComponent(sessionId)}&holderId=${encodeURIComponent(holderId)}`
     return this.client.request(
-      `/v1/automations/${encodeURIComponent(slug)}/dev/session?${q}`,
+      `/v1/functions/${encodeURIComponent(slug)}/dev/session?${q}`,
       { method: 'DELETE' },
     )
   }
 
   registryStatus(): Promise<RegistryStatus> {
-    return this.client.request<RegistryStatus>('/v1/automations/registry-status')
+    return this.client.request<RegistryStatus>('/v1/functions/registry-status')
   }
 
   /**
@@ -317,7 +317,7 @@ export class AutomationApi {
     if (mode === 'dev') params.set('mode', 'dev')
     const query = params.size > 0 ? `?${params}` : ''
     return this.client.request<AutomationRunSummary[]>(
-      `/v1/automations/${encodeURIComponent(slug)}/runs${query}`,
+      `/v1/functions/${encodeURIComponent(slug)}/runs${query}`,
     )
   }
 
@@ -332,7 +332,7 @@ export class AutomationApi {
    */
   runById(slug: string, runId: string): Promise<AutomationRunSummary> {
     return this.client.request<AutomationRunSummary>(
-      `/v1/automations/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,
+      `/v1/functions/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,
     )
   }
 
@@ -340,7 +340,7 @@ export class AutomationApi {
    *  nothing. */
   runSteps(runId: string): Promise<AutomationRunStep[]> {
     return this.client.request<AutomationRunStep[]>(
-      `/v1/automations/runs/${encodeURIComponent(runId)}/steps`,
+      `/v1/functions/runs/${encodeURIComponent(runId)}/steps`,
     )
   }
 
@@ -353,7 +353,7 @@ export class AutomationApi {
    */
   bindings(slug: string): Promise<AgentAutomationBinding[]> {
     return this.client.request<AgentAutomationBinding[]>(
-      `/v1/automations/${encodeURIComponent(slug)}/bindings`,
+      `/v1/functions/${encodeURIComponent(slug)}/bindings`,
     )
   }
 
@@ -363,7 +363,7 @@ export class AutomationApi {
     options: { enabled?: boolean; requiresApproval?: boolean; waitSeconds?: number } = {},
   ): Promise<AgentAutomationBinding> {
     return this.client.request<AgentAutomationBinding>(
-      `/v1/automations/${encodeURIComponent(slug)}/bindings/${encodeURIComponent(agentSlug)}`,
+      `/v1/functions/${encodeURIComponent(slug)}/bindings/${encodeURIComponent(agentSlug)}`,
       { method: 'PUT', body: options },
     )
   }
@@ -371,20 +371,20 @@ export class AutomationApi {
   /** The same question from the agent's side: what may this agent start? */
   agentBindings(agentSlug: string): Promise<AgentBindingView[]> {
     return this.client.request<AgentBindingView[]>(
-      `/v1/automations/agent-bindings/${encodeURIComponent(agentSlug)}`,
+      `/v1/functions/agent-bindings/${encodeURIComponent(agentSlug)}`,
     )
   }
 
   unbind(slug: string, agentSlug: string): Promise<{ unbound: boolean }> {
     return this.client.request<{ unbound: boolean }>(
-      `/v1/automations/${encodeURIComponent(slug)}/bindings/${encodeURIComponent(agentSlug)}`,
+      `/v1/functions/${encodeURIComponent(slug)}/bindings/${encodeURIComponent(agentSlug)}`,
       { method: 'DELETE' },
     )
   }
 
   setEnabled(slug: string, enabled: boolean): Promise<{ slug: string; enabled: boolean }> {
     return this.client.request<{ slug: string; enabled: boolean }>(
-      `/v1/automations/${encodeURIComponent(slug)}/enabled`,
+      `/v1/functions/${encodeURIComponent(slug)}/enabled`,
       { method: 'POST', body: { enabled } },
     )
   }
@@ -401,7 +401,7 @@ export class AutomationApi {
   async downloadSource(slug: string, version: number): Promise<Uint8Array> {
     const credential = this.client.config.credential
     const res = await fetch(
-      `${this.client.config.apiBaseUrl}/v1/automations/${encodeURIComponent(slug)}`
+      `${this.client.config.apiBaseUrl}/v1/functions/${encodeURIComponent(slug)}`
         + `/versions/${version}/source`,
       {
         headers: {
@@ -432,8 +432,8 @@ export class AutomationApi {
       throw new CliError(message, {
         code: res.status === 404 ? 'NOT_FOUND' : 'REQUEST_FAILED',
         hint: res.status === 404
-          ? `frontera automation deploy <file>  (from a local copy of ${slug})`
-          : `frontera automation versions ${slug}`,
+          ? `frontera function deploy <file>  (from a local copy of ${slug})`
+          : `frontera function versions ${slug}`,
       })
     }
     return new Uint8Array(await res.arrayBuffer())
@@ -457,7 +457,7 @@ export class AutomationApi {
 
     const credential = this.client.config.credential
     const res = await fetch(
-      `${this.client.config.apiBaseUrl}/v1/automations/${encodeURIComponent(slug)}/versions`,
+      `${this.client.config.apiBaseUrl}/v1/functions/${encodeURIComponent(slug)}/versions`,
       {
         method: 'POST',
         headers: {

package/src/automation-template.ts

@@ -48,7 +48,7 @@ export const AUTOMATION_SDK_FILES = [
  * The files a new automation project contains.
  *
  * The SDK is written into `src/frontera/` rather than declared as a dependency:
- * `@frontera-sdk/automation` is `private: true` and `workspace:*`, so it resolves
+ * `@frontera-sdk/functions` is `private: true` and `workspace:*`, so it resolves
  * nowhere outside this monorepo — which is the entire problem Phase B exists to
  * solve. `package.json` therefore asks for nothing but public npm.
  */
@@ -77,7 +77,7 @@ export function automationScaffoldFiles(name: string): Record<string, string> {
       // A handler is testable without deploying — `createTestContext` is what
       // the starter test uses — so the project ships with somewhere to run it.
       test: 'bun test',
-      deploy: 'frontera automation deploy src/index.ts',
+      deploy: 'frontera function deploy src/index.ts',
     },
     dependencies: {
       // The vendored `frontera/automation/manifest.ts` imports it to validate
@@ -107,8 +107,8 @@ export function automationScaffoldFiles(name: string): Record<string, string> {
       // detail, so publishing the packages later is deleting these lines.
       baseUrl: '.',
       paths: {
-        '@frontera-sdk/automation': ['./src/frontera/automation/index.ts'],
-        '@frontera-sdk/automation/*': ['./src/frontera/automation/*'],
+        '@frontera-sdk/functions': ['./src/frontera/automation/index.ts'],
+        '@frontera-sdk/functions/*': ['./src/frontera/automation/*'],
         '@frontera-sdk/blueprint/types': ['./src/frontera/blueprint/types.ts'],
         '@frontera-sdk/blueprint/*': ['./src/frontera/blueprint/*'],
       },
@@ -116,7 +116,7 @@ export function automationScaffoldFiles(name: string): Record<string, string> {
     include: ['src'],
   }, null, 2) + '\n'
 
-  out['src/index.ts'] = `import { automation } from '@frontera-sdk/automation'
+  out['src/index.ts'] = `import { automation } from '@frontera-sdk/functions'
 
 /**
  * The object type this reads. CHANGE THIS to one of yours —
@@ -177,7 +177,7 @@ export default automation(
 `
 
   out['src/index.test.ts'] = `import { expect, test } from 'bun:test'
-import { createTestContext } from '@frontera-sdk/automation'
+import { createTestContext } from '@frontera-sdk/functions'
 
 import automation, { OBJECT_TYPE } from './index'
 
@@ -215,7 +215,7 @@ test('handles rows', async () => {
 \`\`\`bash
 bun install
 bun run typecheck
-frontera automation deploy src/index.ts
+frontera function deploy src/index.ts
 \`\`\`
 
 The SDK is vendored into \`src/frontera/\` and resolved by the \`paths\` in
@@ -223,7 +223,7 @@ The SDK is vendored into \`src/frontera/\` and resolved by the \`paths\` in
 packages are unpublished, and the vendored copy is what makes this project build
 on a machine that has never seen the Frontera monorepo.
 
-\`frontera automation pull ${name}\` recovers this project from any deployed
+\`frontera function pull ${name}\` recovers this project from any deployed
 version. A \`.env\` here is never uploaded.
 `
 

package/src/commands/automation/bindings.ts

@@ -1,5 +1,5 @@
 /**
- * `frontera automation bind|unbind|bindings` — the operator's half of making an
+ * `frontera function bind|unbind|bindings` — the operator's half of making an
  * automation callable from a conversation.
  *
  * The author's half is in the manifest (`trigger: { agent: true }`, plus a
@@ -21,7 +21,7 @@ function requireSlug(ctx: CommandContext): string {
   if (!slug) {
     throw new UsageError(
       'missing <slug>',
-      'run `frontera automation list` — then pass the slug of the one you mean',
+      'run `frontera function list` — then pass the slug of the one you mean',
     )
   }
   return slug
@@ -40,15 +40,15 @@ function requireAgent(ctx: CommandContext): string {
 
 const bind: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'bind',
     args: [{ name: 'slug', required: true, description: 'automation slug' }],
     flags: { agent: 'string', approval: 'string', wait: 'string' },
     summary: 'Let one agent run this automation from a conversation',
     examples: [
-      'frontera automation bind reconcile-invoices --agent finance-analyst',
-      'frontera automation bind reconcile-invoices --agent analyst --approval auto',
-      'frontera automation bind reconcile-invoices --agent analyst --wait 120',
+      'frontera function bind reconcile-invoices --agent finance-analyst',
+      'frontera function bind reconcile-invoices --agent analyst --approval auto',
+      'frontera function bind reconcile-invoices --agent analyst --wait 120',
     ],
   },
 
@@ -93,12 +93,12 @@ const bind: Command = {
 
 const unbind: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'unbind',
     args: [{ name: 'slug', required: true, description: 'automation slug' }],
     flags: { agent: 'string' },
     summary: 'Stop one agent being able to run this automation',
-    examples: ['frontera automation unbind reconcile-invoices --agent finance-analyst'],
+    examples: ['frontera function unbind reconcile-invoices --agent finance-analyst'],
   },
 
   async run(ctx) {
@@ -117,7 +117,7 @@ const unbind: Command = {
  */
 const bindings: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'bindings',
     args: [
       {
@@ -129,8 +129,8 @@ const bindings: Command = {
     flags: { agent: 'string' },
     summary: 'List the agents that may run an automation, or what one agent may run',
     examples: [
-      'frontera automation bindings reconcile-invoices',
-      'frontera automation bindings --agent finance-analyst',
+      'frontera function bindings reconcile-invoices',
+      'frontera function bindings --agent finance-analyst',
     ],
   },
 

package/src/commands/automation/dev.ts

@@ -2,15 +2,15 @@ import { mkdtempSync, statSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join, resolve } from 'node:path'
 
-import { buildContext } from '@frontera-sdk/automation/runtime'
+import { buildContext } from '@frontera-sdk/functions/runtime'
 import { AutomationApi } from '../../api/automation-api'
 import { CliError, UsageError } from '../../errors'
 import { type Command, type CommandContext } from '../types'
-import { validateInputValue, validateManifest, type InputsSchema } from '@frontera-sdk/automation'
+import { validateInputValue, validateManifest, type InputsSchema } from '@frontera-sdk/functions'
 import { buildAndExtract } from './build-entry'
 
 /**
- * `frontera automation dev` — run the handler in THIS file, from this machine,
+ * `frontera function dev` — run the handler in THIS file, from this machine,
  * triggered from the Console.
  *
  * The loop it replaces is a deploy: build, upload, mint a version, bump the
@@ -272,7 +272,7 @@ async function finishDevRun(
   runToken: string,
   body: { status: 'succeeded' | 'failed'; result?: unknown; errorMessage?: string },
 ): Promise<void> {
-  await fetch(`${apiUrl}/v1/automations/runner/runs/${runId}/finish`, {
+  await fetch(`${apiUrl}/v1/functions/runner/runs/${runId}/finish`, {
     method: 'POST',
     headers: { 'content-type': 'application/json', 'x-automation-run-token': runToken },
     body: JSON.stringify(body),
@@ -322,7 +322,7 @@ export function devStartupManifestGate(errors: string[]): { blocking: string[];
 
 export const automationDev: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'dev',
     args: [
       {
@@ -333,13 +333,13 @@ export const automationDev: Command = {
     ],
     flags: {},
     summary: 'Serve this file to dev runs — no deploy, no version',
-    examples: ['frontera automation dev src/index.ts'],
+    examples: ['frontera function dev src/index.ts'],
   },
 
   async run(ctx: CommandContext) {
     const file = ctx.positional[0]
     if (!file) {
-      throw new UsageError('missing <file>', 'frontera automation dev <file>')
+      throw new UsageError('missing <file>', 'frontera function dev <file>')
     }
     const entry = resolve(file)
     const out = ctx.output
@@ -403,7 +403,7 @@ export const automationDev: Command = {
     // came back empty.
     out.note('[dev] runs are DRY — ctx.agent, ctx.plugin, ctx.http and ctx.blueprint return empty and send nothing')
     if (session.created) out.note(`[dev] created the automation "${slug}" (no version yet)`)
-    out.note(`[dev] waiting — press Run dev in the Console, or \`frontera automation run ${slug} --dev\``)
+    out.note(`[dev] waiting — press Run dev in the Console, or \`frontera function run ${slug} --dev\``)
 
     const workDir = mkdtempSync(join(tmpdir(), 'frontera-dev-'))
     let builds = 0

package/src/commands/automation/index-commands.ts

@@ -2,7 +2,7 @@ import { existsSync, mkdtempSync, rmSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join, resolve } from 'node:path'
 
-import { validateManifest } from '@frontera-sdk/automation'
+import { validateManifest } from '@frontera-sdk/functions'
 
 import { AutomationApi } from '../../api/automation-api'
 import { UsageError } from '../../errors'
@@ -26,7 +26,7 @@ function requireSlug(ctx: CommandContext): string {
   if (!slug) {
     throw new UsageError(
       'missing <slug>',
-      'run `frontera automation list` — then pass the slug of the one you mean',
+      'run `frontera function list` — then pass the slug of the one you mean',
     )
   }
   return slug
@@ -64,7 +64,7 @@ export function runnerWarningFor(
 
 const deploy: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'deploy',
     args: [
       {
@@ -76,15 +76,15 @@ const deploy: Command = {
     flags: { 'no-promote': 'boolean' },
     summary: 'Build and deploy an automation, promoting it live by default',
     examples: [
-      'frontera automation deploy src/daily-digest.ts',
-      'frontera automation deploy src/daily-digest.ts --no-promote',
+      'frontera function deploy src/daily-digest.ts',
+      'frontera function deploy src/daily-digest.ts --no-promote',
     ],
   },
 
   async run(ctx) {
     const file = ctx.positional[0]
     if (!file) {
-      throw new UsageError('missing <file>', 'frontera automation deploy <file>')
+      throw new UsageError('missing <file>', 'frontera function deploy <file>')
     }
 
     const { manifest, code } = await buildAndExtract(file)
@@ -128,8 +128,8 @@ const deploy: Command = {
       ctx.output.note(
         '  warning: no automation project found (no package.json above '
           + `${file}, or the nearest one is a workspace root) — deploying WITHOUT `
-          + 'source, so `frontera automation pull` will not work for this version. '
-          + 'Run `frontera automation init` to author in a project.',
+          + 'source, so `frontera function pull` will not work for this version. '
+          + 'Run `frontera function init` to author in a project.',
       )
     }
 
@@ -158,19 +158,19 @@ const deploy: Command = {
         `Deployed ${slug} v${result.version}` +
         (result.promoted
           ? ' and promoted it'
-          : ` (not promoted — use \`frontera automation promote ${slug} ${result.version}\`)`),
+          : ` (not promoted — use \`frontera function promote ${slug} ${result.version}\`)`),
     }
   },
 }
 
 const list: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'list',
     args: [],
     flags: {},
     summary: 'List automations in this workspace',
-    examples: ['frontera automation list', 'frontera automation list --json'],
+    examples: ['frontera function list', 'frontera function list --json'],
   },
 
   async run(ctx) {
@@ -200,12 +200,12 @@ const list: Command = {
 
 const versions: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'versions',
-    args: [{ name: 'slug', required: true, description: 'automation slug, from `frontera automation list`' }],
+    args: [{ name: 'slug', required: true, description: 'automation slug, from `frontera function list`' }],
     flags: {},
     summary: 'List deployed versions, newest first; * marks the live one',
-    examples: ['frontera automation versions daily-digest'],
+    examples: ['frontera function versions daily-digest'],
   },
 
   async run(ctx) {
@@ -245,15 +245,15 @@ const versions: Command = {
 
 const promote: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'promote',
     args: [
       { name: 'slug', required: true, description: 'automation slug' },
-      { name: 'version', required: true, description: 'version number, from `frontera automation versions`' },
+      { name: 'version', required: true, description: 'version number, from `frontera function versions`' },
     ],
     flags: {},
     summary: 'Move the live pointer to an already-deployed version',
-    examples: ['frontera automation promote daily-digest 3'],
+    examples: ['frontera function promote daily-digest 3'],
   },
 
   async run(ctx) {
@@ -265,7 +265,7 @@ const promote: Command = {
     if (raw === undefined || !Number.isInteger(version)) {
       throw new UsageError(
         `version must be an integer, got ${raw === undefined ? '(none)' : `"${raw}"`}`,
-        `run \`frontera automation versions ${slug}\` to see the versions that exist`,
+        `run \`frontera function versions ${slug}\` to see the versions that exist`,
       )
     }
 
@@ -283,12 +283,12 @@ function enabledCommand(verb: 'enable' | 'disable', summary: string): Command {
   const enabled = verb === 'enable'
   return {
     meta: {
-      noun: 'automation',
+      noun: 'function',
       verb,
       args: [{ name: 'slug', required: true, description: 'automation slug' }],
       flags: {},
       summary,
-      examples: [`frontera automation ${verb} daily-digest`],
+      examples: [`frontera function ${verb} daily-digest`],
     },
 
     async run(ctx) {

package/src/commands/automation/init.ts

@@ -6,7 +6,7 @@ import type { Command } from '../types'
 
 export const automationInit: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'init',
     args: [{
       name: 'name',
@@ -15,14 +15,14 @@ export const automationInit: Command = {
     }],
     flags: { dir: 'string' },
     summary: 'Scaffold a new automation project',
-    examples: ['frontera automation init daily-digest'],
+    examples: ['frontera function init daily-digest'],
     // Scaffolding must work before a credential exists.
     offline: true,
   },
 
   async run(ctx) {
     const name = ctx.positional[0]
-    if (!name) throw new UsageError('missing <name>', 'frontera automation init <name>')
+    if (!name) throw new UsageError('missing <name>', 'frontera function init <name>')
 
     const base = typeof ctx.flags.dir === 'string' ? ctx.flags.dir : ctx.cwd
     const target = join(base, name)
@@ -45,7 +45,7 @@ export const automationInit: Command = {
         `  cd ${name}`,
         '  bun install',
         '  bun run typecheck',
-        '  frontera automation deploy src/index.ts',
+        '  frontera function deploy src/index.ts',
       ].join('\n'),
     }
   },

package/src/commands/automation/pull.ts

@@ -10,18 +10,18 @@ import { flagBool, type Command } from '../types'
 export function parseTarget(raw: string): { slug: string; version: number | null } {
   const at = raw.lastIndexOf('@')
   if (at === -1) {
-    if (!raw) throw new UsageError('missing slug', 'frontera automation pull <slug>[@version]')
+    if (!raw) throw new UsageError('missing slug', 'frontera function pull <slug>[@version]')
     return { slug: raw, version: null }
   }
   const slug = raw.slice(0, at)
   const rest = raw.slice(at + 1)
-  if (!slug) throw new UsageError('missing slug', 'frontera automation pull <slug>[@version]')
+  if (!slug) throw new UsageError('missing slug', 'frontera function pull <slug>[@version]')
   if (!/^\d+$/.test(rest)) {
     // Not silently falling back to latest: handing back a different version than
     // the one named is the failure mode this phase exists to prevent.
     throw new UsageError(
       `version must be a number, got "${rest}"`,
-      'frontera automation pull <slug>@3',
+      'frontera function pull <slug>@3',
     )
   }
   return { slug, version: Number(rest) }
@@ -65,7 +65,7 @@ export function resolveTargetDir(
 
 export const automationPull: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'pull',
     args: [{
       name: 'slug[@version]',
@@ -75,14 +75,14 @@ export const automationPull: Command = {
     flags: { dir: 'string', force: 'boolean' },
     summary: 'Hydrate an editable project from a deployed version',
     examples: [
-      'frontera automation pull daily-digest',
-      'frontera automation pull daily-digest@3 --dir ./recovered',
+      'frontera function pull daily-digest',
+      'frontera function pull daily-digest@3 --dir ./recovered',
     ],
   },
 
   async run(ctx) {
     const raw = ctx.positional[0]
-    if (!raw) throw new UsageError('missing <slug>', 'frontera automation pull <slug>[@version]')
+    if (!raw) throw new UsageError('missing <slug>', 'frontera function pull <slug>[@version]')
     const { slug, version } = parseTarget(raw)
 
     const client = new AutomationApi(ctx.apiUrl, ctx.token, ctx.workspaceId)
@@ -117,7 +117,7 @@ export const automationPull: Command = {
         '',
         `  cd ${target}`,
         '  bun install',
-        '  frontera automation deploy src/index.ts',
+        '  frontera function deploy src/index.ts',
       ].join('\n'),
     }
   },