@idapt/cli 1.13.0 → 2.1.0

package/dist/index.d.cts

@@ -7,11 +7,13 @@ import { HttpContext } from '@idapt/sdk';
  * Each endpoint is described once as a {@link V1CommandSpec}: its zod request +
  * response schemas (snake_case, matching the wire), its HTTP binding, the
  * `idapt <resource> <verb>` grammar it maps to, and the surface flags that
- * decide whether it appears in the public OpenAPI spec and/or as an agent tool.
+ * decide whether it appears in the public OpenAPI spec, as an agent/CLI tool,
+ * and in the generated SDK dynamic `client.call()` bindings.
  *
  * Consumers (all derive from these specs — nothing is hand-maintained twice):
  *  - v1 route handlers      → import the request/response schemas for validation
- *  - `@idapt/sdk`           → derives wire TYPES via `z.infer` (type-only import)
+ *  - `@idapt/sdk`           → derives wire TYPES via `z.infer` and generated
+ *                             bindings from the `sdkExposed` specs
  *  - `shared/api/v1/openapi` → GENERATED from the `public` specs
  *  - `@idapt/cli`   → builds its command catalog (grammar + HTTP binding
  *                             + docs) from the `agentExposed` specs
@@ -59,6 +61,27 @@ interface V1ErrorOverride {
     }>>;
 }
 type V1OpError = V1ErrorStatus | V1ErrorOverride;
+/**
+ * Public API date-version documentation override.
+ *
+ * Runtime compatibility still lives explicitly in the route/action boundary.
+ * These branches let generated artifacts describe old supported wire contracts
+ * without duplicating the route tree or the whole command registry. The OpenAPI
+ * generator applies the first branch whose `before` date is after the selected
+ * API version, so keep branches ordered from oldest cutoff to newest cutoff.
+ */
+interface V1VersionBranch {
+    /** Use this override for public API versions before this YYYY-MM-DD date. */
+    readonly before: string;
+    readonly request?: z.ZodTypeAny;
+    readonly response?: z.ZodTypeAny | null;
+    readonly responseKind?: ResponseKind;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly requestExample?: unknown;
+    readonly responseExample?: unknown;
+    readonly deprecated?: boolean;
+}
 /**
  * Optional documentation + binding metadata carried by every command. These
  * feed the GENERATED OpenAPI spec (`scripts/generate-openapi.ts`); none affect
@@ -113,6 +136,8 @@ interface V1CommandDocFields {
     readonly idempotent?: boolean;
     /** Marks the operation `deprecated` in the spec. */
     readonly deprecated?: boolean;
+    /** Version-specific contract docs for older supported public API dates. */
+    readonly versionBranches?: readonly V1VersionBranch[];
 }
 /**
  * Resource type a request field resolves against. The v1 route turns a human
@@ -164,6 +189,13 @@ interface V1CommandSpec extends V1CommandDocFields {
     readonly public: boolean;
     /** Exposed as an agent tool (dispatcher / MCP / `idapt`). */
     readonly agentExposed: boolean;
+    /**
+     * Exposed through the generated `@idapt/sdk` dynamic command bindings and
+     * `client.call()` autocomplete. Omitted means exposed. Set `false` for
+     * pre-GA/default-off commands that may exist in the registry for routes/tests
+     * but must not appear in the published SDK surface yet.
+     */
+    readonly sdkExposed?: boolean;
     /**
      * Workspace-scope behavior for the IN-APP agent dispatcher only (CLI / MCP
      * always pass `workspace_id` explicitly and are unaffected):
@@ -385,6 +417,21 @@ interface ExecuteOptions {
      * {@link executeCommand} seam (in-chat dispatcher / MCP) never sets it.
      */
     readonly defaultWorkspaceRef?: string;
+    /**
+     * CLI ambient acting AGENT (resourceId | name) from `idapt agent use` or a
+     * per-call `--agent`. Injected as `agent_id` on `chat create` ONLY (that verb
+     * binds the acting agent; blanket `agent_id` injection would mis-scope
+     * `chat send`'s `sender_agent_id`, agent-CRUD filters, etc.), and only on the
+     * CLI-string path. An explicit `--agent-id`/positional still wins.
+     */
+    readonly defaultAgentRef?: string;
+    /**
+     * The selected agent's Memory box resourceId (from `idapt agent use`). Injected
+     * as the `:id` of `memory` verbs that address a box, when the call didn't name
+     * one — the client-side twin of the in-run dispatcher's box auto-injection, so
+     * `idapt memory …` reads/writes the selected agent's Memory.
+     */
+    readonly defaultAgentMemoryBoxId?: string;
 }
 interface ExecuteResult {
     readonly ok: boolean;

package/dist/index.d.ts

@@ -7,11 +7,13 @@ import { HttpContext } from '@idapt/sdk';
  * Each endpoint is described once as a {@link V1CommandSpec}: its zod request +
  * response schemas (snake_case, matching the wire), its HTTP binding, the
  * `idapt <resource> <verb>` grammar it maps to, and the surface flags that
- * decide whether it appears in the public OpenAPI spec and/or as an agent tool.
+ * decide whether it appears in the public OpenAPI spec, as an agent/CLI tool,
+ * and in the generated SDK dynamic `client.call()` bindings.
  *
  * Consumers (all derive from these specs — nothing is hand-maintained twice):
  *  - v1 route handlers      → import the request/response schemas for validation
- *  - `@idapt/sdk`           → derives wire TYPES via `z.infer` (type-only import)
+ *  - `@idapt/sdk`           → derives wire TYPES via `z.infer` and generated
+ *                             bindings from the `sdkExposed` specs
  *  - `shared/api/v1/openapi` → GENERATED from the `public` specs
  *  - `@idapt/cli`   → builds its command catalog (grammar + HTTP binding
  *                             + docs) from the `agentExposed` specs
@@ -59,6 +61,27 @@ interface V1ErrorOverride {
     }>>;
 }
 type V1OpError = V1ErrorStatus | V1ErrorOverride;
+/**
+ * Public API date-version documentation override.
+ *
+ * Runtime compatibility still lives explicitly in the route/action boundary.
+ * These branches let generated artifacts describe old supported wire contracts
+ * without duplicating the route tree or the whole command registry. The OpenAPI
+ * generator applies the first branch whose `before` date is after the selected
+ * API version, so keep branches ordered from oldest cutoff to newest cutoff.
+ */
+interface V1VersionBranch {
+    /** Use this override for public API versions before this YYYY-MM-DD date. */
+    readonly before: string;
+    readonly request?: z.ZodTypeAny;
+    readonly response?: z.ZodTypeAny | null;
+    readonly responseKind?: ResponseKind;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly requestExample?: unknown;
+    readonly responseExample?: unknown;
+    readonly deprecated?: boolean;
+}
 /**
  * Optional documentation + binding metadata carried by every command. These
  * feed the GENERATED OpenAPI spec (`scripts/generate-openapi.ts`); none affect
@@ -113,6 +136,8 @@ interface V1CommandDocFields {
     readonly idempotent?: boolean;
     /** Marks the operation `deprecated` in the spec. */
     readonly deprecated?: boolean;
+    /** Version-specific contract docs for older supported public API dates. */
+    readonly versionBranches?: readonly V1VersionBranch[];
 }
 /**
  * Resource type a request field resolves against. The v1 route turns a human
@@ -164,6 +189,13 @@ interface V1CommandSpec extends V1CommandDocFields {
     readonly public: boolean;
     /** Exposed as an agent tool (dispatcher / MCP / `idapt`). */
     readonly agentExposed: boolean;
+    /**
+     * Exposed through the generated `@idapt/sdk` dynamic command bindings and
+     * `client.call()` autocomplete. Omitted means exposed. Set `false` for
+     * pre-GA/default-off commands that may exist in the registry for routes/tests
+     * but must not appear in the published SDK surface yet.
+     */
+    readonly sdkExposed?: boolean;
     /**
      * Workspace-scope behavior for the IN-APP agent dispatcher only (CLI / MCP
      * always pass `workspace_id` explicitly and are unaffected):
@@ -385,6 +417,21 @@ interface ExecuteOptions {
      * {@link executeCommand} seam (in-chat dispatcher / MCP) never sets it.
      */
     readonly defaultWorkspaceRef?: string;
+    /**
+     * CLI ambient acting AGENT (resourceId | name) from `idapt agent use` or a
+     * per-call `--agent`. Injected as `agent_id` on `chat create` ONLY (that verb
+     * binds the acting agent; blanket `agent_id` injection would mis-scope
+     * `chat send`'s `sender_agent_id`, agent-CRUD filters, etc.), and only on the
+     * CLI-string path. An explicit `--agent-id`/positional still wins.
+     */
+    readonly defaultAgentRef?: string;
+    /**
+     * The selected agent's Memory box resourceId (from `idapt agent use`). Injected
+     * as the `:id` of `memory` verbs that address a box, when the call didn't name
+     * one — the client-side twin of the in-run dispatcher's box auto-injection, so
+     * `idapt memory …` reads/writes the selected agent's Memory.
+     */
+    readonly defaultAgentMemoryBoxId?: string;
 }
 interface ExecuteResult {
     readonly ok: boolean;

package/dist/index.js

@@ -1,3 +1,3 @@
-export { VERB_OVERRIDES, autoMode, commandsForResource, createFetchTransport, execute, executeCommand, findCommand, getResourcePlaybook, listCommands, listResources, mapArgsToV1, parseInvocation, reconcileToV1, render, renderHelp, renderInstructions, resolveCommand, toSnakeKey } from './chunk-CZEBGFAQ.js';
+export { VERB_OVERRIDES, autoMode, commandsForResource, createFetchTransport, execute, executeCommand, findCommand, getResourcePlaybook, listCommands, listResources, mapArgsToV1, parseInvocation, reconcileToV1, render, renderHelp, renderInstructions, resolveCommand, toSnakeKey } from './chunk-AR3DW2SX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idapt/cli",
-  "version": "1.13.0",
+  "version": "2.1.0",
   "description": "The idapt CLI — the `idapt <resource> <verb>` grammar, command→REST translation, help/instructions, output formatting, SOTA auth (OAuth 2.1 + PKCE / device-code / API-key) and self-update, over the public v1 API. One implementation shared by the in-chat dispatcher, MCP, and the `idapt` CLI binary.",
   "license": "Apache-2.0",
   "homepage": "https://idapt.app/cli",