@xanots/sdk 0.0.5 → 0.0.6

package/dist/{chunk-OARSPAIE.js → chunk-TYBB7ON3.js}

@@ -27,15 +27,15 @@ import {
   resolveFrontendPreset,
   resolveThemeChoice,
   sanitizeAppName
-} from "./chunk-KXCPZUUM.js";
+} from "./chunk-4HDOP7LH.js";
 import {
   XANO_DIR,
   resolveAiPresets,
   scaffoldProject
-} from "./chunk-7SISR3CS.js";
+} from "./chunk-2SUCC4DV.js";
 import {
   TEST_EXPECT_TYPES
-} from "./chunk-PXXLBXOP.js";
+} from "./chunk-JRGDLAEA.js";
 import {
   raw
 } from "./chunk-LU7TRWMC.js";
@@ -44,7 +44,7 @@ import {
   describeOrigin,
   renderCodegenMarker,
   renderCodegenReadme
-} from "./chunk-QUUB7HYK.js";
+} from "./chunk-P5C2YKAM.js";
 import {
   FIELD_METHODS,
   STATEMENT_SURFACES,
@@ -67,14 +67,14 @@ import {
   searchConstrainsRows,
   tableTrigger,
   workspaceTrigger
-} from "./chunk-CYJ7R3AD.js";
+} from "./chunk-GC7ZQHW7.js";
 import {
   loadDefault,
   readVersion
-} from "./chunk-MS3BRZAZ.js";
+} from "./chunk-SOCYCBYG.js";
 import {
   UsageError
-} from "./chunk-IVP6TS26.js";
+} from "./chunk-JQLR64UC.js";
 import {
   blank,
   detail,
@@ -115,7 +115,7 @@ import {
   sys,
   toolset,
   withFilters
-} from "./chunk-YUPQOLFX.js";
+} from "./chunk-CQBJNFDK.js";
 import {
   parsePathParams,
   unboundPathParams
@@ -130,7 +130,7 @@ import {
 } from "./chunk-5XZ744TS.js";
 import {
   REFERENCEABLE_KIND_PAYLOAD_KEYS
-} from "./chunk-YUBJLB6G.js";
+} from "./chunk-EFH4NFPY.js";
 
 // src/emit/codegen-command.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -2732,10 +2732,7 @@ function callDecoder(shape) {
         shape.path
       );
     }
-    const target = unbound ? lit(null) : shape.external ? obj2([
-      ["name", lit("")],
-      ["guid", lit(guid)]
-    ]) : resolveReference(a.ctx, a.refs, guid, { ...a.resolve, unresolved: "object-ref" });
+    const target = unbound ? lit(null) : resolveReference(a.ctx, a.refs, guid, { ...a.resolve, unresolved: "object-ref" });
     const entries = [[shape.arg, target]];
     const runtime = {
       [shape.arg]: unbound ? null : { name: "", guid }
@@ -2845,11 +2842,7 @@ var CALL_DECODERS = /* @__PURE__ */ new Map([
     "mvp:workspace_run_middleware",
     callDecoder({ path: "middleware.call", arg: "middleware", idPath: "id" })
   ],
-  ["mvp:workspace_run_addon", callDecoder({ path: "addon.call", arg: "addon", idPath: "id" })],
-  [
-    "mvp:action",
-    callDecoder({ path: "action.call", arg: "action", idPath: "run_version.id", external: true })
-  ]
+  ["mvp:workspace_run_addon", callDecoder({ path: "addon.call", arg: "addon", idPath: "id" })]
 ]);
 
 // src/codegen/specials/db.ts
@@ -4032,26 +4025,52 @@ function callInput2(a) {
   }
   return { expr: obj2(cells), runtime };
 }
+function registryInput(a) {
+  const list = a.stored.settings_registry;
+  return callInput2({ ...a, stored: { ...a.stored, input: Array.isArray(list) ? list : [] } });
+}
+function withCallBindings(a, entries, runtime) {
+  for (const [key2, read] of [
+    ["input", callInput2],
+    ["registry", registryInput]
+  ]) {
+    const decoded = read(a);
+    if (!decoded) return false;
+    if (Object.keys(decoded.runtime).length > 0) {
+      entries.push([key2, decoded.expr]);
+      runtime[key2] = decoded.runtime;
+    }
+  }
+  return true;
+}
+var actionCall = (a) => {
+  const context = a.stored.context ?? {};
+  const id2 = getPath2(context, "run_version.id");
+  if (typeof id2 !== "string" || id2 === "")
+    return declineHere("action.call: context.run_version.id is blank");
+  const entries = [["actionId", lit(id2)]];
+  const runtime = { actionId: id2 };
+  withAs(a, entries, runtime);
+  if (!withCallBindings(a, entries, runtime)) return null;
+  return prove(a.ctx, a.stored, "action.call", [runtime], [obj2(entries)]);
+};
 var actionPackageCall = (a) => {
   const context = a.stored.context ?? {};
-  if (getPath2(context, "action.trace_id") !== "" || getPath2(context, "package_version.id") !== "")
-    return declineHere("action.package.call: statement carries a marketplace identity");
-  const slug = getPath2(context, "package.slug");
-  if (typeof slug !== "string")
-    return declineHere("action.package.call: context.package.slug is not a string");
-  const entries = [["action", lit("")]];
-  const runtime = { action: "" };
-  if (slug !== "") {
-    entries.push(["package", lit(slug)]);
-    runtime.package = slug;
-  }
-  const input2 = callInput2(a);
-  if (!input2) return null;
-  if (Object.keys(input2.runtime).length > 0) {
-    entries.push(["input", input2.expr]);
-    runtime.input = input2.runtime;
+  const parts = {
+    traceId: getPath2(context, "action.trace_id"),
+    versionId: getPath2(context, "package_version.id"),
+    slug: getPath2(context, "package.slug")
+  };
+  const entries = [];
+  const runtime = {};
+  for (const [arg, value] of Object.entries(parts)) {
+    if (typeof value !== "string" || value === "")
+      return declineHere(`action.package.call: context identity part \`${arg}\` is blank`);
+    entries.push([arg, lit(value)]);
+    runtime[arg] = value;
   }
   withAs(a, entries, runtime);
+  if (!withCallBindings(a, entries, runtime)) return null;
   return prove(a.ctx, a.stored, "action.package.call", [runtime], [obj2(entries)]);
 };
 var workflowTestCall = (a) => {
@@ -4165,6 +4184,7 @@ var MISC_DECODERS = /* @__PURE__ */ new Map([
   ["mvp:realtime_publish", realtimePublish],
   ["mvp:create_auth", createAuthToken],
   ["mvp:guid", createGuid],
+  ["mvp:action", actionCall],
   ["mvp:action_package", actionPackageCall],
   ["mvp:workspace_run_workflow_test", workflowTestCall]
 ]);
@@ -6745,7 +6765,7 @@ async function fetchBundle(args, source) {
       );
     }
     const auth3 = await getAccessToken(args);
-    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-46SL27GJ.js");
+    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-K3UJSDS4.js");
     const summary = await resolveLive(auth3, auth3.workspaceId, name);
     step(`Reading ephemeral "${name}"`);
     return {
@@ -7014,4 +7034,4 @@ export {
   verifyCrashEntry,
   blameGeneratedFile
 };
-//# sourceMappingURL=chunk-OARSPAIE.js.map
+//# sourceMappingURL=chunk-TYBB7ON3.js.map

package/dist/{chunk-ZGA5MUNC.js → chunk-Y7BARS25.js}

@@ -1,6 +1,6 @@
 import {
   readVersion
-} from "./chunk-MS3BRZAZ.js";
+} from "./chunk-SOCYCBYG.js";
 import {
   atomicWrite
 } from "./chunk-GNPVYOPB.js";
@@ -170,4 +170,4 @@ export {
   upgradeCommand,
   maybeNotifyUpdate
 };
-//# sourceMappingURL=chunk-ZGA5MUNC.js.map
+//# sourceMappingURL=chunk-Y7BARS25.js.map

package/dist/cli.d.ts

@@ -190,8 +190,8 @@ interface ParsedArgs {
     /**
      * `init`/`codegen` `--theme <id>`: the shadcn/ui palette to render into the
      * scaffold's stylesheet — a `<base>` or `<base>-<accent>` pair, a registry
-     * theme URL, or a path to a registry item JSON file. Undefined = prompt in a
-     * TTY, else plain shadcn. Validated in `theme-presets.ts`, not at parse time.
+     * theme URL, or a path to a registry item JSON file. Undefined = plain
+     * shadcn. Validated in `theme-presets.ts`, not at parse time.
      */
     theme: string | undefined;
     /** `init`/`codegen` `--radius <len>`: corner radius override, bare number = rem. */
@@ -274,6 +274,32 @@ interface ParsedArgs {
      * Named rather than implicit so it can never be reached by accident.
      */
     replace: boolean;
+    /**
+     * `release --branch <label>`: land on this branch instead of the live one.
+     *
+     * The staging boundary for a workspace that has no second workspace. Branches
+     * scope LOGIC only — see {@link allowSharedSchemaChanges}.
+     */
+    branch: string | undefined;
+    /**
+     * `release --branch <label> --set-live`: promote the branch the moment the
+     * import lands, in the same call.
+     */
+    setLive: boolean;
+    /**
+     * `release --branch <label> --allow-shared-schema-changes`: proceed even
+     * though the bundle changes tables or microservices.
+     *
+     * Those carry no branch dimension, so they reach PRODUCTION whichever branch
+     * is targeted. A separate flag rather than a prompt, because the failure mode
+     * is not knowing — and `--yes` in CI answers a prompt without reading it.
+     */
+    allowSharedSchemaChanges: boolean;
+    /**
+     * `release --backup-branch[=<label>]`: clone the live branch before importing,
+     * so a bad promote is one `set-live` away from being undone.
+     */
+    backupBranch: string | boolean | undefined;
     /**
      * `--json`: force the machine-readable JSON on stdout even at a terminal.
      * Absent, the format is inferred from stdout being a TTY. Read through

package/dist/cli.js

@@ -8,17 +8,17 @@ import {
   resolveHelpRequest,
   resolveLockPath,
   run
-} from "./chunk-MS3BRZAZ.js";
-import "./chunk-IVP6TS26.js";
-import "./chunk-MFIHIS6B.js";
+} from "./chunk-SOCYCBYG.js";
+import "./chunk-JQLR64UC.js";
+import "./chunk-OLQLJY5T.js";
 import "./chunk-GNPVYOPB.js";
 import "./chunk-EZG76F7R.js";
-import "./chunk-BPEEGJJA.js";
-import "./chunk-F5T45NAM.js";
-import "./chunk-YUPQOLFX.js";
+import "./chunk-3FQD3QME.js";
+import "./chunk-OKNSR7MT.js";
+import "./chunk-CQBJNFDK.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-YUBJLB6G.js";
+import "./chunk-EFH4NFPY.js";
 export {
   compileBundle,
   exportBundleJson,

package/dist/{codegen-command-BLOS3GR3.js → codegen-command-6XXOIQ25.js}

@@ -4,35 +4,35 @@ import {
   isMissingDependencyError,
   runCodegenCommand,
   verifyCrashEntry
-} from "./chunk-OARSPAIE.js";
+} from "./chunk-TYBB7ON3.js";
 import "./chunk-ZOYMZZ3S.js";
 import "./chunk-SG4UBJ47.js";
 import "./chunk-LLWK6H77.js";
 import "./chunk-QTNO2WD6.js";
 import "./chunk-ZUTSMMAG.js";
 import "./chunk-X4DVXBFY.js";
-import "./chunk-KXCPZUUM.js";
-import "./chunk-7SISR3CS.js";
+import "./chunk-4HDOP7LH.js";
+import "./chunk-2SUCC4DV.js";
 import "./chunk-ZSYZTGJH.js";
 import "./chunk-3IGNIP6R.js";
-import "./chunk-PXXLBXOP.js";
+import "./chunk-JRGDLAEA.js";
 import "./chunk-LU7TRWMC.js";
-import "./chunk-WGDAOOXG.js";
-import "./chunk-QUUB7HYK.js";
-import "./chunk-6DHJVLYP.js";
+import "./chunk-MU3O43L2.js";
+import "./chunk-P5C2YKAM.js";
+import "./chunk-Q77KNEUL.js";
 import "./chunk-4BXJGVZ3.js";
-import "./chunk-CYJ7R3AD.js";
-import "./chunk-MS3BRZAZ.js";
-import "./chunk-IVP6TS26.js";
-import "./chunk-MFIHIS6B.js";
+import "./chunk-GC7ZQHW7.js";
+import "./chunk-SOCYCBYG.js";
+import "./chunk-JQLR64UC.js";
+import "./chunk-OLQLJY5T.js";
 import "./chunk-GNPVYOPB.js";
 import "./chunk-EZG76F7R.js";
-import "./chunk-BPEEGJJA.js";
-import "./chunk-F5T45NAM.js";
-import "./chunk-YUPQOLFX.js";
+import "./chunk-3FQD3QME.js";
+import "./chunk-OKNSR7MT.js";
+import "./chunk-CQBJNFDK.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-YUBJLB6G.js";
+import "./chunk-EFH4NFPY.js";
 export {
   blameGeneratedFile,
   fetchWorkspaceBundle,
@@ -40,4 +40,4 @@ export {
   runCodegenCommand,
   verifyCrashEntry
 };
-//# sourceMappingURL=codegen-command-BLOS3GR3.js.map
+//# sourceMappingURL=codegen-command-6XXOIQ25.js.map

package/dist/{completion-GHP5RRLQ.js → completion-A6BZ3XGU.js}

@@ -4,8 +4,9 @@ import {
   flagValues,
   getCommand,
   liveCommandNames,
-  liveSubcommandNames
-} from "./chunk-F5T45NAM.js";
+  liveSubcommandNames,
+  visibleFlags
+} from "./chunk-OKNSR7MT.js";
 
 // src/emit/completion.ts
 var COMPLETION_SHELLS = ["bash", "zsh", "fish"];
@@ -46,19 +47,19 @@ function scopes() {
     const spec = getCommand(name);
     out.push({
       key: name,
-      flags: tokensFor(spec.flags),
+      flags: tokensFor(visibleFlags(spec)),
       paths: wantsPaths(spec.args),
       values: argValues(spec.args),
-      valued: valuedFlags(spec.flags)
+      valued: valuedFlags(visibleFlags(spec))
     });
     for (const verb of liveSubcommandNames(name)) {
       const sub = spec.subcommands[verb];
       out.push({
         key: `${name} ${verb}`,
-        flags: tokensFor(sub.flags),
+        flags: tokensFor(visibleFlags(sub)),
         paths: wantsPaths(sub.args),
         values: argValues(sub.args),
-        valued: valuedFlags(sub.flags)
+        valued: valuedFlags(visibleFlags(sub))
       });
     }
   }
@@ -295,4 +296,4 @@ export {
   renderCompletion,
   runCompletionCommand
 };
-//# sourceMappingURL=completion-GHP5RRLQ.js.map
+//# sourceMappingURL=completion-A6BZ3XGU.js.map

package/dist/{deploy-command-XOH76USO.js → deploy-command-MTQQXPOO.js}

@@ -1,10 +1,10 @@
 import {
   importWorkspaceArchive
-} from "./chunk-5WGEURVI.js";
+} from "./chunk-6AAT2AYQ.js";
 import {
   assertBundleInput,
   loadBundleText
-} from "./chunk-QA5ICJ4M.js";
+} from "./chunk-QVSUMHNN.js";
 import {
   createEphemeral,
   getEphemeral,
@@ -42,11 +42,11 @@ import {
   fetchOrExplain,
   httpFailure
 } from "./chunk-3IGNIP6R.js";
-import "./chunk-MS3BRZAZ.js";
+import "./chunk-SOCYCBYG.js";
 import {
   assertWritableDest
-} from "./chunk-IVP6TS26.js";
-import "./chunk-MFIHIS6B.js";
+} from "./chunk-JQLR64UC.js";
+import "./chunk-OLQLJY5T.js";
 import "./chunk-GNPVYOPB.js";
 import {
   blank,
@@ -62,12 +62,12 @@ import {
   warn,
   withSpinner
 } from "./chunk-EZG76F7R.js";
-import "./chunk-BPEEGJJA.js";
-import "./chunk-F5T45NAM.js";
-import "./chunk-YUPQOLFX.js";
+import "./chunk-3FQD3QME.js";
+import "./chunk-OKNSR7MT.js";
+import "./chunk-CQBJNFDK.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-YUBJLB6G.js";
+import "./chunk-EFH4NFPY.js";
 
 // src/emit/deploy-command.ts
 import { basename } from "path";
@@ -158,7 +158,7 @@ async function runDeployedTests(auth, dest, summary, args) {
   }
 }
 async function runTestsOrThrow(auth, dest, summary, args) {
-  const { runSuite, EXIT_TESTS_FAILED } = await import("./test-command-56IAEYHX.js");
+  const { runSuite, EXIT_TESTS_FAILED } = await import("./test-command-OEBIGOPP.js");
   let target;
   if (dest === "ephemeral") {
     if (summary.url === void 0) {
@@ -168,7 +168,7 @@ async function runTestsOrThrow(auth, dest, summary, args) {
     const name = summary.ephemeral?.name;
     target = { base: summary.url, workspaceId: 1, label: name ? `ephemeral ${name}` : "the ephemeral", env: name };
   } else {
-    const { resolveMetaTarget } = await import("./env-target-POGJMD6Q.js");
+    const { resolveMetaTarget } = await import("./env-target-C5JFLDK3.js");
     target = await resolveMetaTarget(auth, { dest: "sandbox" });
   }
   const outcomes = await runSuite(auth, target, {
@@ -448,4 +448,4 @@ export {
   runDeployedTests,
   verifyMicroservices
 };
-//# sourceMappingURL=deploy-command-XOH76USO.js.map
+//# sourceMappingURL=deploy-command-MTQQXPOO.js.map

package/dist/{env-target-POGJMD6Q.js → env-target-C5JFLDK3.js}

@@ -1,6 +1,6 @@
 import {
   resolveMetaTarget
-} from "./chunk-APOR6TCV.js";
+} from "./chunk-CEFYM6N5.js";
 import "./chunk-WJYB7DSI.js";
 import "./chunk-OR43PDCW.js";
 import "./chunk-NDZFBZHC.js";
@@ -13,4 +13,4 @@ import "./chunk-EZG76F7R.js";
 export {
   resolveMetaTarget
 };
-//# sourceMappingURL=env-target-POGJMD6Q.js.map
+//# sourceMappingURL=env-target-C5JFLDK3.js.map

package/dist/{ephemeral-command-46SL27GJ.js → ephemeral-command-K3UJSDS4.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-W5NOKYEG.js";
 import {
   confirm
-} from "./chunk-PGBK64U5.js";
+} from "./chunk-4PTSTDIG.js";
 import {
   resolveOutputTarget
 } from "./chunk-AAFBSOSD.js";
@@ -41,7 +41,7 @@ import {
 import "./chunk-3IGNIP6R.js";
 import {
   unknownSubcommand
-} from "./chunk-IVP6TS26.js";
+} from "./chunk-JQLR64UC.js";
 import "./chunk-GNPVYOPB.js";
 import {
   detail,
@@ -53,7 +53,7 @@ import {
   success,
   warn
 } from "./chunk-EZG76F7R.js";
-import "./chunk-F5T45NAM.js";
+import "./chunk-OKNSR7MT.js";
 
 // src/emit/ephemeral-command.ts
 import { writeFileSync } from "fs";
@@ -90,7 +90,7 @@ async function runEphemeralCommand(args) {
     case "impersonate":
       return runImpersonate(args);
     case "codegen": {
-      const { runCodegenCommand } = await import("./codegen-command-BLOS3GR3.js");
+      const { runCodegenCommand } = await import("./codegen-command-6XXOIQ25.js");
       return runCodegenCommand(args, { kind: "ephemeral" });
     }
     default:
@@ -239,4 +239,4 @@ export {
   resolveLive,
   runEphemeralCommand
 };
-//# sourceMappingURL=ephemeral-command-46SL27GJ.js.map
+//# sourceMappingURL=ephemeral-command-K3UJSDS4.js.map

package/dist/index.d.ts

@@ -649,16 +649,20 @@ interface AsyncRuntime {
  * api.call emits the `headers`/`auth` blocks (verb/name/api_group are
  * engine-derived, not stored).
  *
+ * `action.call` / `action.package.call` are the exception to the paragraph
+ * above: their target is NOT a workspace object, so no id is derived for them
+ * and the author supplies one. See {@link ActionCallArgs} for why.
+ *
  * @TODO(byte-verify): `function.run` (mvp:function), `api.call` (context.token
  *   confirmed tagged), and — since the workflow-test capture — `function.call`
  *   (mvp:workspace_run_function) are golden-verified. Still modeled/unverified:
  *   - the remaining `workspace_run_*` (task/tool/trigger/middleware/addon) — no
  *     golden, but they share the single-key `id` context two goldens now pin.
  *   - `workflow_test` → context.{datasource,id} — decode-accurate, no golden.
- *   - action / action_package — EXCLUDED from byte-verify: they need an
- *     action-identity model first (action id currently resolves via the "function"
- *     migrate type, likely wrong; action_package is emitted empty). See their own
- *     @TODOs below — do not vendor/capture until the identity model exists.
+ *   - action / action_package — the stored shape is pinned against the engine's
+ *     own authoring schema and its two transforms, and the ids are now carried
+ *     verbatim rather than derived, so a capture is finally meaningful. It needs
+ *     an instance with the package actually installed.
  */
 
 /** A call/agent `{name: value}` input map — raw scalar literals coerce to constants. */
@@ -830,37 +834,76 @@ interface AddonCallArgs extends StatementOptions {
 }
 /** `addon.call <addon>` — invoke an addon as a workspace run. */
 declare function addonCall(args: AddonCallArgs): Statement;
+/**
+ * Why an action is identified by a LITERAL id and not by a name or a handle.
+ *
+ * Every other call in this file targets a workspace object, so its id is
+ * derivable: the name plus the object type is enough, because the SDK and the
+ * engine agree on how a workspace object is keyed. An action is not a workspace
+ * object. It is a third-party package INSTALLED onto the instance, and its
+ * identity is assigned at install time by the instance that installed it.
+ *
+ * Nothing offline can compute that. There is no name-to-id rule to reimplement —
+ * the mapping is a lookup over what happens to be installed, so the same action
+ * name resolves differently on two instances and to nothing at all on a third.
+ * That is also why an installed action never appears in the bundle's object
+ * graph: it is not part of the workspace's source.
+ *
+ * So the author supplies the id, and the SDK stores it verbatim. Deriving one
+ * from a name would produce a confident, well-formed value that addresses
+ * nothing — the failure mode this shape exists to make impossible.
+ *
+ * Where to find the ids: read them off an existing call in a pulled workspace,
+ * which round-trips them unchanged.
+ */
 interface ActionCallArgs extends StatementOptions {
-    /** The action's name. */
-    action: ObjectRef;
-    /** The action package identifier. */
-    package?: string;
+    /**
+     * The installed action's id, stored verbatim as `context.run_version.id`.
+     *
+     * Assigned when the action was installed — not derivable from the action's
+     * name, and not the same value on another instance.
+     */
+    actionId: string;
     as?: string;
+    /** Arguments passed to the action. */
     input?: CallInput;
+    /**
+     * The action's own settings (`settings_registry`) — an installed action's
+     * configured values, keyed by setting name. Separate from {@link input},
+     * which carries the per-call arguments.
+     */
+    registry?: CallInput;
 }
 /**
- * `action.call <action>` — invoke a marketplace/action operation (`mvp:action`).
- * Stored shape from the engine's action-call format: `context.run_version.id` is the action
- * id and `settings_registry` is always present.
+ * `action.call` — invoke an installed action (`mvp:action`).
  *
- * @TODO(byte-verify): xanots has no `action` kind, so the id resolves via the
- *   "function" migrate type — likely WRONG (actions are a distinct namespace,
- *   `mapActionNameToId`). input[] uses the lean shape; the engine uses
- *   `convertBlockToInput` (may be the rich form). No golden.
+ * Stores `context.run_version.id` verbatim; see {@link ActionCallArgs} for why
+ * the id is supplied rather than derived.
  */
 declare function actionCall(args: ActionCallArgs): Statement;
+interface ActionPackageCallArgs extends StatementOptions {
+    /** The installed package's trace id (`context.action.trace_id`). */
+    traceId: string;
+    /** The installed package VERSION's id (`context.package_version.id`). */
+    versionId: string;
+    /** The package's slug (`context.package.slug`). */
+    slug: string;
+    as?: string;
+    /** Arguments passed to the action. */
+    input?: CallInput;
+    /** The action's own settings (`settings_registry`), keyed by setting name. */
+    registry?: CallInput;
+}
 /**
- * `action.package.call <action>` — invoke an action-package operation
- * (`mvp:action_package`). Stored shape from the engine's action-package format:
- * `context.{action:{trace_id}, package:{slug}, package_version:{id}}`.
+ * `action.package.call` — invoke an action inside an installed package
+ * (`mvp:action_package`).
  *
- * @TODO(byte-verify): MODELED skeleton only — xanots doesn't model marketplace
- *   action packages (trace_id / package slug / version id come from
- *   `mapActionPackageNameToId`), so these are emitted EMPTY. This statement is a
- *   reachable placeholder, NOT functional, until the action-package identity model
- *   exists. No golden.
+ * Stores `context.{action.trace_id, package.slug, package_version.id}`. The
+ * three travel together: they are one composite identity the instance assigns at
+ * install, so a call carrying two of them addresses nothing. Same sourcing as
+ * {@link ActionCallArgs} — read them off an existing call in a pulled workspace.
  */
-declare function actionPackageCall(args: ActionCallArgs): Statement;
+declare function actionPackageCall(args: ActionPackageCallArgs): Statement;
 interface WorkflowTestCallArgs extends StatementOptions {
     /** The target workflow test. */
     workflowTest: ObjectRef;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
 import {
   TEST_EXPECT_TYPES,
   expect
-} from "./chunk-PXXLBXOP.js";
+} from "./chunk-JRGDLAEA.js";
 import {
   addon,
   agent,
@@ -17,7 +17,7 @@ import {
   task,
   tool,
   workflowTest
-} from "./chunk-FN4OQT2J.js";
+} from "./chunk-CU5VOSTW.js";
 import {
   actionCall,
   actionPackageCall,
@@ -100,11 +100,11 @@ import {
   workflowTestCall,
   workspaceConfig,
   workspaceTrigger
-} from "./chunk-CYJ7R3AD.js";
+} from "./chunk-GC7ZQHW7.js";
 import {
   Xano,
   workspace
-} from "./chunk-BPEEGJJA.js";
+} from "./chunk-3FQD3QME.js";
 import {
   LAMBDA_BINDINGS,
   LAMBDA_CODE_FILTERS,
@@ -148,7 +148,7 @@ import {
   toSearchParams,
   toolset,
   withFilters
-} from "./chunk-YUPQOLFX.js";
+} from "./chunk-CQBJNFDK.js";
 import "./chunk-WHOJWOSV.js";
 import {
   annotate,
@@ -157,7 +157,7 @@ import {
 import {
   resetLockOverrides,
   seedLockOverrides
-} from "./chunk-YUBJLB6G.js";
+} from "./chunk-EFH4NFPY.js";
 export {
   LAMBDA_BINDINGS,
   LAMBDA_CODE_FILTERS,