@superdurable/dex-agents-vercel-ai-cli 0.0.0 → 0.5.0

package/LICENSE

@@ -0,0 +1,105 @@
+# License
+
+Copyright (c) 2026 Super Durable, Inc.
+
+Portions of this software are licensed as follows:
+
+- Legacy Materials remain under their original licenses as described in
+  `LEGACY_NOTICES.md`.
+- Third-Party Materials remain under the licenses provided by their owners.
+- The `docs/` and `examples/` directories are not licensed under the
+  Sustainable Use License and retain their existing licensing status.
+- All other material owned or licensable by Super Durable, Inc. is available
+  under the Sustainable Use License below.
+
+See `LEGACY_NOTICES.md` for the applicable legacy and third-party notices.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes
+or for non-commercial or personal use. You may distribute the software or
+provide it to others only if you do so free of charge for non-commercial
+purposes. You may not alter, remove, or obscure any licensing, copyright, or
+other notices of the licensor in the software. Any use of the licensor's
+trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms. If you modify the software, you must
+include in any modified copies of the software a prominent notice stating that
+you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your license will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your license will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your license
+to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms,
+including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these
+terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.

package/README.md

@@ -1,6 +1,77 @@
 # @superdurable/dex-agents-vercel-ai-cli
 
-This version is a placeholder that reserves the package name. It contains no code.
-The first real release of this Dex agents package will replace it.
+`@superdurable/dex-agents-vercel-ai-cli` provides the `dex-agents-vercel-ai`
+command. It runs a [Vercel AI SDK](https://ai-sdk.dev) agent as a durable Dex
+agent session and chats with it in your terminal. The shared CLI core,
+[`@superdurable/dex-agents-cli-core`](../core/README.md), starts or reuses
+`dexcli dev`, connects the connectors MCP server, offers the local tools, and
+runs the Worker. This package only builds the agent with the
+[Vercel AI SDK adapter](../../../typescript/vercel-ai/README.md).
 
-Source: https://github.com/superdurable/dex/tree/main/agents/cli/typescript/vercel-ai
+## Running it
+
+The command needs Node.js 22 or 24 and a provider API key:
+
+```bash
+export OPENAI_API_KEY=sk-...
+npx -p @superdurable/dex-agents-vercel-ai-cli dex-agents-vercel-ai
+```
+
+The first run asks the `init` questions and writes
+`~/.dex/agents/vercel-ai.yaml`. Then type a message. Approve or reject tool
+calls with `y` or `n`, and type `/exit` to leave. The session stays in Dex,
+and the command prints the `--resume` line that continues it. See the
+[CLI core README](../core/README.md) for every subcommand and option, and
+[`agents/cli`](../../README.md) for the configuration file.
+
+## Models and keys
+
+The model defaults to `openai/gpt-5.2`; set `model` in the file or pass
+`--model` to change it. A model ID names its provider:
+
+| Model ID | Provider package | Environment variables |
+| --- | --- | --- |
+| `openai/<model>`, such as `openai/gpt-5.2` | `@ai-sdk/openai`, Responses API | `OPENAI_API_KEY`, optional `OPENAI_BASE_URL` |
+| `anthropic/<model>`, such as `anthropic/claude-sonnet-4-5` | `@ai-sdk/anthropic` | `ANTHROPIC_API_KEY`, optional `ANTHROPIC_BASE_URL` |
+
+Any other model ID stops the command, or fails the turn when session settings
+set it. The command never passes a model ID string to the AI SDK, so no model
+call goes to the Vercel AI Gateway. It never prints or stores a key; the
+provider package reads it from the environment on each model call.
+
+## Configuration and tools
+
+The `vercel_ai` section has no options yet, and any key in it is a
+configuration error.
+
+The agent offers the connectors MCP server's tools and the CLI core's
+[local tools](../core/README.md#local-tools), each call in its own tool Step
+with the CLI core's approval rules. The adapter takes one model and fixed
+instructions per Flow, so the command passes it a language model,
+**TurnLanguageModel**, that serves each model call with the running turn's
+model and adds the turn's instructions as the system message. Each turn
+therefore uses the model and instructions its session settings resolve to.
+
+## Images
+
+`/image <path>` attaches an image file to the next message. The command gives
+the Vercel AI SDK adapter the media store of `media.store`, so the model sees the
+image, and images that tools return go to the same store. See
+[Images](../../README.md#images).
+
+## Development
+
+`ci.sh` builds the core, the Vercel AI SDK adapter, and the CLI core, which this
+package installs from the repository, then typechecks and runs the integration
+tests against a private `dexcli dev`:
+
+```bash
+cd agents/cli/typescript/vercel-ai
+DEXCLI=/path/to/dexcli ./ci.sh
+```
+
+`dex-server-zd` must sit next to `dexcli`. The tests run the command as a child
+process with a private home and an explicit environment allow list. Its
+`@ai-sdk/openai` model calls `test/fixtures/mock-responses-api.ts`, a scripted
+Responses API on 127.0.0.1, through `OPENAI_BASE_URL`, and its connector tools
+come from `test/fixtures/fake-connectors-mcp-server.ts`.

package/dist/src/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/bin.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { processAgentCliIo, runAgentCli } from "@superdurable/dex-agents-cli-core";
+import { vercelAiHarness } from "./vercel-ai-harness.js";
+// Exit explicitly: open connections can keep Node running after the chat ends.
+process.exit(await runAgentCli(vercelAiHarness, processAgentCliIo()));
+//# sourceMappingURL=bin.js.map

package/dist/src/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":";AACA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,+EAA+E;AAC/E,OAAO,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The `dex-agents-vercel-ai` command: a Vercel AI SDK agent in the terminal. It builds the agent session Flow with
+ * the Vercel AI SDK adapter and runs it with the shared Dex Agents CLI core.
+ *
+ * @packageDocumentation
+ */
+export { createProviderLanguageModel, supportedModelProviders } from "./provider-language-models.js";
+export { TurnLanguageModel } from "./turn-language-model.js";
+export { createVercelAiCliSessionFlow, defaultInstructions, defaultVercelAiModel, validateVercelAiSection, vercelAiCliFlowType, vercelAiHarness, } from "./vercel-ai-harness.js";

package/dist/src/index.js

@@ -0,0 +1,17 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+/**
+ * The `dex-agents-vercel-ai` command: a Vercel AI SDK agent in the terminal. It builds the agent session Flow with
+ * the Vercel AI SDK adapter and runs it with the shared Dex Agents CLI core.
+ *
+ * @packageDocumentation
+ */
+export { createProviderLanguageModel, supportedModelProviders } from "./provider-language-models.js";
+export { TurnLanguageModel } from "./turn-language-model.js";
+export { createVercelAiCliSessionFlow, defaultInstructions, defaultVercelAiModel, validateVercelAiSection, vercelAiCliFlowType, vercelAiHarness, } from "./vercel-ai-harness.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D;;;;;GAKG;AAEH,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/src/provider-language-models.d.ts

@@ -0,0 +1,22 @@
+import type { LanguageModelV4 } from "@ai-sdk/provider";
+/**
+ * The model providers the command supports, as the prefix of a `<provider>/<model>` model ID. Each provider
+ * package reads its standard environment variables: `OPENAI_API_KEY` and `OPENAI_BASE_URL`, or
+ * `ANTHROPIC_API_KEY` and `ANTHROPIC_BASE_URL`.
+ *
+ * @since 0.5.0
+ */
+export declare const supportedModelProviders: readonly string[];
+/**
+ * Returns the AI SDK language model of a `<provider>/<model>` model ID, such as `openai/gpt-5.2` or
+ * `anthropic/claude-sonnet-4-5`. OpenAI models use the Responses API.
+ *
+ * A model ID string is never passed to the AI SDK itself, which would send it to the Vercel AI Gateway.
+ *
+ * @param modelId - The model ID.
+ * @returns The model.
+ * @throws {Error} When the prefix is not one of {@link supportedModelProviders}. The message leaves the model ID
+ * out, because session settings may hold it.
+ * @since 0.5.0
+ */
+export declare function createProviderLanguageModel(modelId: string): LanguageModelV4;

package/dist/src/provider-language-models.js

@@ -0,0 +1,44 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { anthropic } from "@ai-sdk/anthropic";
+import { openai } from "@ai-sdk/openai";
+/**
+ * The model providers the command supports, as the prefix of a `<provider>/<model>` model ID. Each provider
+ * package reads its standard environment variables: `OPENAI_API_KEY` and `OPENAI_BASE_URL`, or
+ * `ANTHROPIC_API_KEY` and `ANTHROPIC_BASE_URL`.
+ *
+ * @since 0.5.0
+ */
+export const supportedModelProviders = Object.freeze(["openai", "anthropic"]);
+/**
+ * Returns the AI SDK language model of a `<provider>/<model>` model ID, such as `openai/gpt-5.2` or
+ * `anthropic/claude-sonnet-4-5`. OpenAI models use the Responses API.
+ *
+ * A model ID string is never passed to the AI SDK itself, which would send it to the Vercel AI Gateway.
+ *
+ * @param modelId - The model ID.
+ * @returns The model.
+ * @throws {Error} When the prefix is not one of {@link supportedModelProviders}. The message leaves the model ID
+ * out, because session settings may hold it.
+ * @since 0.5.0
+ */
+export function createProviderLanguageModel(modelId) {
+    const separator = modelId.indexOf("/");
+    const provider = separator < 0 ? "" : modelId.slice(0, separator);
+    const providerModelId = modelId.slice(separator + 1);
+    if (providerModelId !== "") {
+        if (provider === "openai") {
+            return openai(providerModelId);
+        }
+        if (provider === "anthropic") {
+            return anthropic(providerModelId);
+        }
+    }
+    throw new Error("the model must be openai/<model> or anthropic/<model>");
+}
+//# sourceMappingURL=provider-language-models.js.map

package/dist/src/provider-language-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-language-models.js","sourceRoot":"","sources":["../../src/provider-language-models.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACrD,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QAC3B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/turn-language-model.d.ts

@@ -0,0 +1,55 @@
+import type { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult } from "@ai-sdk/provider";
+import type { ResolvedTurn } from "@superdurable/dex-agents-cli-core";
+/**
+ * An AI SDK language model that serves each call with the model and instructions of the turn whose model call is
+ * running.
+ *
+ * The Vercel AI SDK adapter takes one model and fixed instructions for the whole Flow, while a CLI session may
+ * change both per turn through its session settings. This model reads the running turn on every call, delegates
+ * to that turn's model, and adds the turn's instructions as the system message when the prompt has none.
+ *
+ * @example
+ * ```ts
+ * const model = new TurnLanguageModel(() => context.currentTurn(), createProviderLanguageModel, "Help the user.");
+ * const flow = createVercelAiAgentSessionFlow({ model, toolSources: context.toolSources }, context.flowType);
+ * ```
+ * @since 0.5.0
+ */
+export declare class TurnLanguageModel implements LanguageModelV4 {
+    private readonly currentTurn;
+    private readonly createModel;
+    private readonly defaultInstructions;
+    /** The AI SDK specification version. */
+    readonly specificationVersion = "v4";
+    private readonly models;
+    /**
+     * Creates the model.
+     *
+     * @param currentTurn - Returns the running turn's configuration, such as `HarnessContext.currentTurn`.
+     * @param createModel - Returns the language model of a model ID; its result is cached per ID.
+     * @param defaultInstructions - The instructions of a turn that sets none.
+     */
+    constructor(currentTurn: () => ResolvedTurn, createModel: (modelId: string) => LanguageModelV4, defaultInstructions: string);
+    /** The running turn's model provider. */
+    get provider(): string;
+    /** The running turn's provider model ID. */
+    get modelId(): string;
+    /** The URLs the running turn's model accepts. */
+    get supportedUrls(): LanguageModelV4["supportedUrls"];
+    /**
+     * Generates with the running turn's model.
+     *
+     * @param options - The call options.
+     * @returns The model's result.
+     */
+    doGenerate(options: LanguageModelV4CallOptions): PromiseLike<LanguageModelV4GenerateResult>;
+    /**
+     * Streams with the running turn's model.
+     *
+     * @param options - The call options.
+     * @returns The model's stream.
+     */
+    doStream(options: LanguageModelV4CallOptions): PromiseLike<LanguageModelV4StreamResult>;
+    private turnModel;
+    private withInstructions;
+}

package/dist/src/turn-language-model.js

@@ -0,0 +1,89 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+/**
+ * An AI SDK language model that serves each call with the model and instructions of the turn whose model call is
+ * running.
+ *
+ * The Vercel AI SDK adapter takes one model and fixed instructions for the whole Flow, while a CLI session may
+ * change both per turn through its session settings. This model reads the running turn on every call, delegates
+ * to that turn's model, and adds the turn's instructions as the system message when the prompt has none.
+ *
+ * @example
+ * ```ts
+ * const model = new TurnLanguageModel(() => context.currentTurn(), createProviderLanguageModel, "Help the user.");
+ * const flow = createVercelAiAgentSessionFlow({ model, toolSources: context.toolSources }, context.flowType);
+ * ```
+ * @since 0.5.0
+ */
+export class TurnLanguageModel {
+    currentTurn;
+    createModel;
+    defaultInstructions;
+    /** The AI SDK specification version. */
+    specificationVersion = "v4";
+    models = new Map();
+    /**
+     * Creates the model.
+     *
+     * @param currentTurn - Returns the running turn's configuration, such as `HarnessContext.currentTurn`.
+     * @param createModel - Returns the language model of a model ID; its result is cached per ID.
+     * @param defaultInstructions - The instructions of a turn that sets none.
+     */
+    constructor(currentTurn, createModel, defaultInstructions) {
+        this.currentTurn = currentTurn;
+        this.createModel = createModel;
+        this.defaultInstructions = defaultInstructions;
+    }
+    /** The running turn's model provider. */
+    get provider() {
+        return this.turnModel().provider;
+    }
+    /** The running turn's provider model ID. */
+    get modelId() {
+        return this.turnModel().modelId;
+    }
+    /** The URLs the running turn's model accepts. */
+    get supportedUrls() {
+        return this.turnModel().supportedUrls;
+    }
+    /**
+     * Generates with the running turn's model.
+     *
+     * @param options - The call options.
+     * @returns The model's result.
+     */
+    doGenerate(options) {
+        return this.turnModel().doGenerate(this.withInstructions(options));
+    }
+    /**
+     * Streams with the running turn's model.
+     *
+     * @param options - The call options.
+     * @returns The model's stream.
+     */
+    doStream(options) {
+        return this.turnModel().doStream(this.withInstructions(options));
+    }
+    turnModel() {
+        const modelId = this.currentTurn().model;
+        let model = this.models.get(modelId);
+        if (model === undefined) {
+            model = this.createModel(modelId);
+            this.models.set(modelId, model);
+        }
+        return model;
+    }
+    withInstructions(options) {
+        if (options.prompt.some((message) => message.role === "system")) {
+            return options;
+        }
+        const instructions = this.currentTurn().instructions ?? this.defaultInstructions;
+        return { ...options, prompt: [{ role: "system", content: instructions }, ...options.prompt] };
+    }
+}
+//# sourceMappingURL=turn-language-model.js.map

package/dist/src/turn-language-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-language-model.js","sourceRoot":"","sources":["../../src/turn-language-model.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAU1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAiB;IAaT;IACA;IACA;IAdnB,wCAAwC;IACxB,oBAAoB,GAAG,IAAI,CAAC;IAC3B,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE7D;;;;;;OAMG;IACH,YACmB,WAA+B,EAC/B,WAAiD,EACjD,mBAA2B;QAF3B,gBAAW,GAAX,WAAW,CAAoB;QAC/B,gBAAW,GAAX,WAAW,CAAsC;QACjD,wBAAmB,GAAnB,mBAAmB,CAAQ;IAC3C,CAAC;IAEJ,yCAAyC;IACzC,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,4CAA4C;IAC5C,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,iDAAiD;IACjD,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,aAAa,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,OAAmC;QACnD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,OAAmC;QACjD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,SAAS;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC;QACzC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,OAAmC;QAC1D,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAChE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC;QACjF,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAChG,CAAC;CACF"}

package/dist/src/vercel-ai-harness.d.ts

@@ -0,0 +1,55 @@
+import { type AgentHarness, type HarnessContext } from "@superdurable/dex-agents-cli-core";
+import { createVercelAiAgentSessionFlow } from "@superdurable/dex-agents-vercel-ai";
+/**
+ * The base Flow type of the command's sessions, before the CLI core namespaces it.
+ *
+ * @since 0.5.0
+ */
+export declare const vercelAiCliFlowType = "DexAgentsVercelAiCliSession";
+/**
+ * The model the command uses when the configuration file sets none.
+ *
+ * @since 0.5.0
+ */
+export declare const defaultVercelAiModel = "openai/gpt-5.2";
+/**
+ * The instructions the agent gets when the configuration sets none.
+ *
+ * @since 0.5.0
+ */
+export declare const defaultInstructions: string;
+/**
+ * The `dex-agents-vercel-ai` command: a Vercel AI SDK agent in the terminal.
+ *
+ * The agent offers the CLI core's connector and local tools. The model ID is `openai/<model>` or
+ * `anthropic/<model>`; each turn uses the model and instructions its session settings resolve to. The
+ * `vercel_ai` section has no options yet; any key in it is a configuration error.
+ *
+ * @example
+ * ```ts
+ * import { processAgentCliIo, runAgentCli } from "@superdurable/dex-agents-cli-core";
+ * import { vercelAiHarness } from "@superdurable/dex-agents-vercel-ai-cli";
+ *
+ * process.exit(await runAgentCli(vercelAiHarness, processAgentCliIo()));
+ * ```
+ * @since 0.5.0
+ */
+export declare const vercelAiHarness: AgentHarness;
+/**
+ * Builds the Vercel AI SDK agent session Flow from the effective configuration.
+ *
+ * @param context - The configuration, workspace, and tool sources.
+ * @returns The Flow, with `context.flowType` as its type.
+ * @throws {ConfigError} When the `vercel_ai` section has a key.
+ * @throws {Error} When the file's model is not `openai/<model>` or `anthropic/<model>`.
+ * @since 0.5.0
+ */
+export declare function createVercelAiCliSessionFlow(context: HarnessContext): ReturnType<typeof createVercelAiAgentSessionFlow>;
+/**
+ * Rejects every key of the `vercel_ai` section, which has no options yet.
+ *
+ * @param options - The section, `{}` when the file omits it.
+ * @throws {ConfigError} A `schema` error with the first key's JSON Pointer.
+ * @since 0.5.0
+ */
+export declare function validateVercelAiSection(options: Readonly<Record<string, unknown>>): void;

package/dist/src/vercel-ai-harness.js

@@ -0,0 +1,84 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { ConfigError } from "@superdurable/dex-agents-cli-core";
+import { createVercelAiAgentSessionFlow } from "@superdurable/dex-agents-vercel-ai";
+import { createProviderLanguageModel } from "./provider-language-models.js";
+import { TurnLanguageModel } from "./turn-language-model.js";
+/**
+ * The base Flow type of the command's sessions, before the CLI core namespaces it.
+ *
+ * @since 0.5.0
+ */
+export const vercelAiCliFlowType = "DexAgentsVercelAiCliSession";
+/**
+ * The model the command uses when the configuration file sets none.
+ *
+ * @since 0.5.0
+ */
+export const defaultVercelAiModel = "openai/gpt-5.2";
+/**
+ * The instructions the agent gets when the configuration sets none.
+ *
+ * @since 0.5.0
+ */
+export const defaultInstructions = "You are a helpful assistant. Use your tools to work with the files and commands in your workspace and with " +
+    "the connected services.";
+/**
+ * The `dex-agents-vercel-ai` command: a Vercel AI SDK agent in the terminal.
+ *
+ * The agent offers the CLI core's connector and local tools. The model ID is `openai/<model>` or
+ * `anthropic/<model>`; each turn uses the model and instructions its session settings resolve to. The
+ * `vercel_ai` section has no options yet; any key in it is a configuration error.
+ *
+ * @example
+ * ```ts
+ * import { processAgentCliIo, runAgentCli } from "@superdurable/dex-agents-cli-core";
+ * import { vercelAiHarness } from "@superdurable/dex-agents-vercel-ai-cli";
+ *
+ * process.exit(await runAgentCli(vercelAiHarness, processAgentCliIo()));
+ * ```
+ * @since 0.5.0
+ */
+export const vercelAiHarness = {
+    name: "vercel-ai",
+    configSection: "vercel_ai",
+    flowType: vercelAiCliFlowType,
+    defaultModel: defaultVercelAiModel,
+    createSessionFlow: (context) => createVercelAiCliSessionFlow(context),
+};
+/**
+ * Builds the Vercel AI SDK agent session Flow from the effective configuration.
+ *
+ * @param context - The configuration, workspace, and tool sources.
+ * @returns The Flow, with `context.flowType` as its type.
+ * @throws {ConfigError} When the `vercel_ai` section has a key.
+ * @throws {Error} When the file's model is not `openai/<model>` or `anthropic/<model>`.
+ * @since 0.5.0
+ */
+export function createVercelAiCliSessionFlow(context) {
+    validateVercelAiSection(context.harnessOptions);
+    // Fail at startup, not at the first turn, when the file's model has no supported provider.
+    createProviderLanguageModel(context.config.model);
+    const model = new TurnLanguageModel(() => context.currentTurn(), createProviderLanguageModel, defaultInstructions);
+    return createVercelAiAgentSessionFlow({ model, toolSources: context.toolSources }, context.flowType, context.mediaStore === undefined ? {} : { mediaStore: context.mediaStore });
+}
+/**
+ * Rejects every key of the `vercel_ai` section, which has no options yet.
+ *
+ * @param options - The section, `{}` when the file omits it.
+ * @throws {ConfigError} A `schema` error with the first key's JSON Pointer.
+ * @since 0.5.0
+ */
+export function validateVercelAiSection(options) {
+    const [firstKey] = Object.keys(options).sort();
+    if (firstKey !== undefined) {
+        const escaped = firstKey.replaceAll("~", "~0").replaceAll("/", "~1");
+        throw new ConfigError("schema", `/vercel_ai/${escaped}`, "additionalProperties");
+    }
+}
+//# sourceMappingURL=vercel-ai-harness.js.map

package/dist/src/vercel-ai-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai-harness.js","sourceRoot":"","sources":["../../src/vercel-ai-harness.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,WAAW,EAA0C,MAAM,mCAAmC,CAAC;AACxG,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,6GAA6G;IAC7G,yBAAyB,CAAC;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,WAAW;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,YAAY,EAAE,oBAAoB;IAClC,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC;CACtE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAuB;IAClE,uBAAuB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,2FAA2F;IAC3F,2BAA2B,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;IACnH,OAAO,8BAA8B,CACnC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAC3C,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAC3E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA0C;IAChF,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrE,MAAM,IAAI,WAAW,CAAC,QAAQ,EAAE,cAAc,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@superdurable/dex-agents-vercel-ai-cli",
-  "version": "0.0.0",
-  "description": "Placeholder that reserves the name for a Dex agents package. It contains no code; the first real release follows.",
+  "version": "0.5.0",
+  "description": "The dex-agents-vercel-ai command: a durable Vercel AI SDK agent in your terminal",
   "license": "LicenseRef-Sustainable-Use-1.0",
   "repository": {
     "type": "git",
@@ -9,10 +9,57 @@
     "directory": "agents/cli/typescript/vercel-ai"
   },
   "homepage": "https://github.com/superdurable/dex/tree/main/agents/cli/typescript/vercel-ai#readme",
+  "bugs": {
+    "url": "https://github.com/superdurable/dex/issues"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "engines": {
+    "node": "^22.0.0 || ^24.0.0"
+  },
+  "bin": {
+    "dex-agents-vercel-ai": "dist/src/bin.js"
+  },
   "files": [
-    "README.md"
+    "dist/src",
+    "README.md",
+    "LICENSE"
   ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test --test-concurrency=1 --test-timeout=300000 'dist/test/integ/*.integration.test.js'"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "4.0.94",
+    "@ai-sdk/openai": "4.0.106",
+    "@ai-sdk/provider": "4.0.35",
+    "ai": "7.0.159"
+  },
+  "peerDependencies": {
+    "@superdurable/dex": "1.45.0",
+    "@superdurable/dex-agents": "^0.5.0",
+    "@superdurable/dex-agents-cli-core": "^0.5.0",
+    "@superdurable/dex-agents-vercel-ai": "^0.5.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.32.2",
+    "@superdurable/dex": "1.45.0",
+    "@superdurable/dex-agents": "file:../../../typescript/core",
+    "@superdurable/dex-agents-cli-core": "file:../core",
+    "@superdurable/dex-agents-vercel-ai": "file:../../../typescript/vercel-ai",
+    "@types/node": "22.20.5",
+    "typescript": "5.9.3",
+    "zod": "4.6.7"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   }
-}
+}