動作

// src/actions/approve_invoice.action.ts
import { Action } from '@objectstack/spec/ui';

export const approveInvoice = Action.create({
  name: 'approve_invoice',          // lowercase snake_case (machine id)
  label: 'Approve Invoice',
  objectName: 'invoice',            // attaches to the invoice object
  icon: 'check',
  variant: 'primary',
  locations: ['record_header'],     // where the button shows
  description: 'Approve this invoice?',  // shown in the param dialog
  successMessage: 'Invoice approved',
  refreshAfter: true,

  // collect input before running
  params: [
    { name: 'note', label: 'Approval note', type: 'textarea' },
  ],

  // only show the button when the record is still pending
  visible: 'record.status == "pending"',

  // expose it to agents and the AI Builder as `action_approve_invoice`
  ai: {
    exposed: true,
    description: 'Approve a pending invoice, recording the approver and an optional note.',
  },

  // what it does — a sandboxed script body. `input` is the params bag;
  // `ctx.record` is a read-only snapshot, so the write goes through `ctx.api`,
  // which needs the `api.write` capability
  type: 'script',
  body: {
    language: 'js',
    capabilities: ['api.write'],
    source: `
      await ctx.api.object('invoice').update({
        id: ctx.recordId,
        status: 'approved',
        approved_by: ctx.user.id,
        approved_at: new Date().toISOString(),
        approval_note: input.note,
      });
    `,
  },
});

// api type — reuse a data-API endpoint
Action.create({
  name: 'archive_order',
  objectName: 'order',
  label: 'Archive',
  locations: ['list_item'],
  type: 'api',
  method: 'PATCH',
  target: '/api/v1/data/order/{id}',
  bodyExtra: { archived: true },
});

# the record id can go in the body, or in the path
curl -X POST https://app.example.com/api/v1/actions/invoice/approve_invoice/inv_123 \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"note": "LGTM"}'

// One list view; the container and `data` are omitted (see Views).
{
  type: 'grid',
  columns: ['number', 'customer', 'amount', 'status'],
  rowActions: ['approve_invoice', 'reject_invoice'],
  bulkActions: ['send_to_customer'],
}

// flow type — start a flow by name
Action.create({
  name: 'run_invoice_approval',
  objectName: 'invoice',
  label: 'Run approval',
  locations: ['record_more'],
  type: 'flow',
  target: 'approve_invoice',
});