@salesforce/sfdx-agent-sdk 0.1.0

package/dist/types/events.d.ts

@@ -0,0 +1,151 @@
+import type { ToolCallInfo, ToolResultInfo } from './tools.js';
+import type { FinishReason, UsageMetadata } from './usage.js';
+/**
+ * Discriminated union of all events emitted during a streaming chat interaction.
+ *
+ * Event type names are aligned with the Vercel AI SDK `TextStreamPart` naming
+ * convention, with the addition of `tool-approval-request` for human-in-the-loop
+ * tool approval flows.
+ */
+export type ChatEvent = StartEvent | TextDeltaEvent | ReasoningDeltaEvent | ToolCallEvent | ToolApprovalRequestEvent | ToolResultEvent | StepStartEvent | StepFinishEvent | ErrorEvent | FinishEvent | UnmappedChunkEvent;
+/**
+ * The stream has begun. Symmetric counterpart to {@link FinishEvent}.
+ *
+ * Aligned with the AI SDK `start` stream event. Emitted once at the very
+ * beginning of the event stream before any content events.
+ */
+export type StartEvent = {
+    type: 'start';
+};
+/**
+ * An incremental text fragment (chunk) from the model's response.
+ *
+ * Concatenate successive `text-delta` events to build the full response text.
+ * The `textStream` on {@link ChatStreamResult} yields these as plain strings.
+ */
+export type TextDeltaEvent = {
+    type: 'text-delta';
+    /** The text fragment. */
+    text: string;
+};
+/**
+ * An incremental reasoning/thought fragment (chunk) from the model's chain-of-thought.
+ *
+ * Concatenate successive `reasoning-delta` events to build the full reasoning text.
+ * These are excluded from `textStream`.
+ */
+export type ReasoningDeltaEvent = {
+    type: 'reasoning-delta';
+    /** The reasoning text fragment. */
+    text: string;
+};
+/**
+ * A real-time stream event indicating the model has invoked a tool.
+ * When the harness supports native tool execution, the tool runs automatically
+ * and a {@link ToolResultEvent} follows. When the harness does not, the consumer
+ * must call `submitToolResult()`.
+ *
+ * Extends {@link ToolCallInfo} with a discriminator type for use in the
+ * {@link ChatEvent} discriminated union.
+ */
+export type ToolCallEvent = ToolCallInfo & {
+    type: 'tool-call';
+};
+/**
+ * The harness is requesting approval before executing a tool call.
+ * The stream suspends until the consumer calls `approveToolCall()` or
+ * `declineToolCall()`. Maps to ACP's `awaiting` run state.
+ *
+ * Uses nested composition (`toolCall: ToolCallInfo`) rather than flat
+ * inheritance because this event is *about* a tool call, not *a* tool call.
+ * This leaves room for approval-specific metadata (e.g., `reason`, `policy`)
+ * without polluting the tool call fields.
+ */
+export type ToolApprovalRequestEvent = {
+    type: 'tool-approval-request';
+    /** The tool call awaiting approval. */
+    toolCall: ToolCallInfo;
+};
+/**
+ * A real-time stream event indicating a tool execution has completed.
+ *
+ * Extends {@link ToolResultInfo} with a discriminator type for use in the
+ * {@link ChatEvent} discriminated union.
+ */
+export type ToolResultEvent = ToolResultInfo & {
+    type: 'tool-result';
+};
+/**
+ * Marks the beginning of a new LLM invocation within a multi-step agentic loop.
+ *
+ * A single `chat()` call may trigger multiple steps — e.g., step 0 generates a tool call,
+ * step 1 processes the tool result and generates the final response. Each step is one
+ * round-trip to the LLM.
+ */
+export type StepStartEvent = {
+    type: 'step-start';
+    /** Zero-based index of this step within the current stream. */
+    stepIndex: number;
+};
+/**
+ * Marks the completion of an LLM invocation within a multi-step agentic loop.
+ *
+ * Carries per-step `usage` (token counts) and `finishReason`, enabling consumers to track
+ * cost and behavior per LLM call. The final {@link FinishEvent} carries aggregate usage
+ * across all steps.
+ */
+export type StepFinishEvent = {
+    type: 'step-finish';
+    /** Zero-based index of the completed step. */
+    stepIndex: number;
+    /** Why this step stopped generating. */
+    finishReason: FinishReason;
+    /** Token usage for this step. */
+    usage?: UsageMetadata;
+};
+/** An error occurred during streaming. */
+export type ErrorEvent = {
+    type: 'error';
+    /** The error that occurred. */
+    error: Error;
+    /** Machine-readable error code (e.g., `'insufficient-tokens'`). */
+    code?: string;
+};
+/**
+ * A stream chunk from the underlying harness that has no `ChatEvent` counterpart.
+ *
+ * Returned instead of silently discarding the chunk, so consumers can log or
+ * monitor unhandled harness events for observability.
+ */
+export type UnmappedChunkEvent = {
+    type: 'unmapped-chunk';
+    /** The original harness chunk type string (e.g., `'tool-call-suspended'`, `'raw'`). */
+    chunkType: string;
+    /** The raw chunk object, preserved for diagnostic logging. */
+    rawChunk: unknown;
+};
+/** The entire stream has completed. */
+export type FinishEvent = {
+    type: 'finish';
+    /** Why the model stopped generating. */
+    finishReason: FinishReason;
+    /** Aggregate token usage for the entire interaction. */
+    usage?: UsageMetadata;
+};
+/**
+ * Result of a streaming chat interaction.
+ * Provides multiple ways to consume the stream, aligned with the AI SDK
+ * and Mastra patterns.
+ */
+export type ChatStreamResult = {
+    /**
+     * Full stream of all lifecycle events.
+     * Interleaves text tokens, tool calls, tool results, and step metadata.
+     */
+    eventStream: AsyncGenerator<ChatEvent>;
+    /**
+     * Convenience stream yielding only the text tokens as plain strings.
+     * Ignores tool calls and metadata.
+     */
+    textStream: AsyncGenerator<string>;
+};

package/dist/types/events.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export type { Message, MessageRole, MessagePart, TextPart, ReasoningPart, ToolCallPart, ToolResultPart, } from './messages.js';
+export type { ChatEvent, StartEvent, TextDeltaEvent, ReasoningDeltaEvent, ToolCallEvent, ToolApprovalRequestEvent, ToolResultEvent, StepStartEvent, StepFinishEvent, ErrorEvent, FinishEvent, ChatStreamResult, } from './events.js';
+export type { ToolDefinition, ToolCallInfo, ToolResultInfo } from './tools.js';
+export type { UsageMetadata, FinishReason } from './usage.js';

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/messages.d.ts

@@ -0,0 +1,60 @@
+import type { ToolCallInfo, ToolResultInfo } from './tools.js';
+/**
+ * Role of a message in a conversation. Aligned with AI SDK `ModelMessage` roles.
+ *
+ * - `system` -- Instructions to the model (not visible to end users)
+ * - `user` -- Messages from the human user
+ * - `assistant` -- Messages generated by the model
+ * - `tool` -- Results from tool executions
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * A single message in a conversation thread.
+ *
+ * Content can be a plain string (shorthand for a single text part) or an
+ * array of typed {@link MessagePart} objects for rich multi-part messages
+ * containing text, reasoning, tool calls, and tool results.
+ *
+ * Structurally compatible with AI SDK `ModelMessage`.
+ */
+export type Message = {
+    /** Unique identifier for the message. */
+    id: string;
+    /** Role of the message author. */
+    role: MessageRole;
+    /** Message content — plain text or structured parts. */
+    content: string | MessagePart[];
+    /** Optional timestamp of when the message was created. */
+    createdAt?: Date;
+};
+/**
+ * Discriminated union of message content parts.
+ * Aligned with AI SDK `TextPart`, `ReasoningPart`, `ToolCallPart`, `ToolResultPart`.
+ */
+export type MessagePart = TextPart | ReasoningPart | ToolCallPart | ToolResultPart;
+/** A plain text content segment. */
+export type TextPart = {
+    type: 'text';
+    /** The text content. */
+    text: string;
+};
+/** A reasoning/thought content segment produced by the model's chain-of-thought. */
+export type ReasoningPart = {
+    type: 'reasoning';
+    /** The reasoning text. */
+    text: string;
+};
+/**
+ * A tool invocation recorded as a content part within a persisted {@link Message}.
+ * Extends {@link ToolCallInfo} with a discriminator type.
+ */
+export type ToolCallPart = ToolCallInfo & {
+    type: 'tool-call';
+};
+/**
+ * A tool result recorded as a content part within a persisted {@link Message}.
+ * Extends {@link ToolResultInfo} with a discriminator type.
+ */
+export type ToolResultPart = ToolResultInfo & {
+    type: 'tool-result';
+};

package/dist/types/messages.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/types/messages.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/telemetry-events.d.ts

@@ -0,0 +1,93 @@
+import type { EventBus } from '@salesforce/agentic-common';
+import type { UsageMetadata } from './usage.js';
+/**
+ * Telemetry events emitted by the Agent SDK.
+ *
+ * The union is stable public API; consumers subscribe via `onTelemetry()` on `AgentManager`, `Agent`, or
+ * `ChatSession`. Routing fields (`agentId`, `threadId`) are typed on the variants that carry them so
+ * internal dispatch does not need to reach into a context bag.
+ */
+type Base<T extends string> = {
+    type: T;
+    timestamp: Date;
+};
+export type AgentCreatedEvent = Base<'agent-created'> & {
+    agentId: string;
+    projectRoot: string;
+    modelName: string;
+};
+export type AgentDestroyedEvent = Base<'agent-destroyed'> & {
+    agentId: string;
+};
+export type SessionCreatedEvent = Base<'session-created'> & {
+    agentId: string;
+    threadId: string;
+};
+export type SessionDestroyedEvent = Base<'session-destroyed'> & {
+    agentId: string;
+    threadId: string;
+};
+export type ChatStreamTrigger = 'chat' | 'submit-tool-result' | 'approve-tool-call' | 'decline-tool-call';
+export type ChatStreamStartedEvent = Base<'chat-stream-started'> & {
+    agentId: string;
+    threadId: string;
+    trigger: ChatStreamTrigger;
+};
+export type ChatStreamCompletedEvent = Base<'chat-stream-completed'> & {
+    agentId: string;
+    threadId: string;
+    durationMs: number;
+    usage?: UsageMetadata;
+};
+export type ChatStreamErrorEvent = Base<'chat-stream-error'> & {
+    agentId: string;
+    threadId: string;
+    durationMs: number;
+    error: Error;
+};
+export type ToolExecutionStartedEvent = Base<'tool-execution-started'> & {
+    agentId: string;
+    threadId: string;
+    toolCallId: string;
+    toolName: string;
+};
+export type ToolExecutionCompletedEvent = Base<'tool-execution-completed'> & {
+    agentId: string;
+    threadId: string;
+    toolCallId: string;
+    toolName: string;
+    durationMs: number;
+    isError: boolean;
+};
+export type ToolApprovalRequestedEvent = Base<'tool-approval-requested'> & {
+    agentId: string;
+    threadId: string;
+    toolCallId: string;
+    toolName: string;
+};
+export type ToolApprovalResolvedEvent = Base<'tool-approval-resolved'> & {
+    agentId: string;
+    threadId: string;
+    toolCallId: string;
+    approved: boolean;
+};
+export type McpServerDiscoveryStartedEvent = Base<'mcp-server-discovery-started'> & {
+    agentId: string;
+    serverName: string;
+};
+export type McpServerDiscoveryCompletedEvent = Base<'mcp-server-discovery-completed'> & {
+    agentId: string;
+    serverName: string;
+    toolCount: number;
+    durationMs: number;
+};
+export type McpServerDiscoveryFailedEvent = Base<'mcp-server-discovery-failed'> & {
+    agentId: string;
+    serverName: string;
+    durationMs: number;
+    error: Error;
+};
+export type TelemetryEvent = AgentCreatedEvent | AgentDestroyedEvent | SessionCreatedEvent | SessionDestroyedEvent | ChatStreamStartedEvent | ChatStreamCompletedEvent | ChatStreamErrorEvent | ToolExecutionStartedEvent | ToolExecutionCompletedEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent | McpServerDiscoveryStartedEvent | McpServerDiscoveryCompletedEvent | McpServerDiscoveryFailedEvent;
+export type TelemetryEventCallback = (event: TelemetryEvent) => void;
+export type TelemetryBus = EventBus<TelemetryEvent>;
+export {};

package/dist/types/telemetry-events.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=telemetry-events.js.map

package/dist/types/telemetry-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-events.js","sourceRoot":"","sources":["../../src/types/telemetry-events.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/tools.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Declares a consumer-executed tool that an agent can invoke.
+ *
+ * Tools declared here are schema-only: the harness registers the name,
+ * description, and input schema with the model so it can generate tool-call
+ * chunks, but the harness never executes these tools itself. When the model
+ * calls one, the stream ends with `finishReason: 'tool-calls'` and the
+ * consumer is responsible for running the tool locally and feeding the result
+ * back via `ChatSession.submitToolResult()`.
+ *
+ * For harness-executed (native) tools such as MCP tools, use
+ * `AgentConfig.mcpServers`. To gate native tool calls with human approval,
+ * use `StreamOptions.requireToolApproval`.
+ *
+ * Structurally compatible with AI SDK `LanguageModelV4FunctionTool`.
+ */
+export type ToolDefinition = {
+    /** Unique name identifying the tool. */
+    name: string;
+    /** Human-readable description shown to the model. */
+    description?: string;
+    /**
+     * JSON Schema describing the tool's expected input.
+     * Harnesses use this to validate arguments before execution.
+     */
+    inputSchema: Record<string, unknown>;
+};
+/**
+ * Base shape for a tool call.
+ *
+ * Used as the parameter to {@link ChatSession.submitToolResult} for client-side tool execution.
+ * Extended by {@link ToolCallPart} (message content) and {@link ToolCallEvent} (stream event).
+ * Also referenced by {@link ToolApprovalRequestEvent}.
+ */
+export type ToolCallInfo = {
+    /** Unique identifier for this tool call instance. */
+    toolCallId: string;
+    /** Name of the tool being called. */
+    toolName: string;
+    /** Arguments the model passed to the tool. */
+    args: Record<string, unknown>;
+};
+/**
+ * Base shape for a tool result.
+ *
+ * Extended by {@link ToolResultPart} (message content) and {@link ToolResultEvent} (stream event).
+ */
+export type ToolResultInfo = {
+    /** Identifier linking this result to the originating tool call. */
+    toolCallId: string;
+    /** Name of the tool that produced this result. */
+    toolName: string;
+    /** The tool's output value. */
+    result: unknown;
+    /** Whether the tool execution resulted in an error. */
+    isError?: boolean;
+};

package/dist/types/tools.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/usage.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Token usage statistics for an LLM interaction.
+ * Structurally compatible with AI SDK `LanguageModelUsage`.
+ */
+export type UsageMetadata = {
+    /** Number of tokens in the input prompt. */
+    inputTokens?: number;
+    /** Number of tokens generated in the output. */
+    outputTokens?: number;
+    /** Sum of input and output tokens. */
+    totalTokens?: number;
+    /** Tokens consumed by the model's reasoning/thinking phase. */
+    reasoningTokens?: number;
+    /** Input tokens served from provider cache (reduces cost). */
+    cachedInputTokens?: number;
+};
+/**
+ * Reason the model stopped generating.
+ * Aligned with AI SDK `LanguageModelV2FinishReason`.
+ *
+ * - `stop` — The model finished generating naturally (complete response).
+ * - `length` — The model hit the maximum output token limit; the response was truncated mid-generation.
+ * - `tool-calls` — The model stopped generating text to invoke one or more tools. Normal in multi-step agentic loops.
+ * - `content-filter` — The provider's safety/moderation filter blocked the response.
+ * - `error` — An error occurred during generation.
+ * - `max-steps` — The agentic loop was terminated because it reached the maximum step count.
+ *   The model wanted to continue (e.g., it was requesting more tool calls) but the loop was forcibly stopped.
+ *   This is distinct from `tool-calls` which in a step-finish context indicates normal mid-loop progress.
+ * - `other` — Provider-specific reason that doesn't map to the standard values.
+ */
+export type FinishReason = 'stop' | 'length' | 'tool-calls' | 'content-filter' | 'error' | 'max-steps' | 'other';

package/dist/types/usage.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+export {};
+//# sourceMappingURL=usage.js.map

package/dist/types/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/types/usage.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/workspace.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validated project path with normalization.
+ *
+ * A convenience class for async path validation + normalization.
+ */
+export declare class Workspace {
+    readonly projectPath: string;
+    private constructor();
+    /**
+     * Creates a validated Workspace.
+     * @param projectPath - Project folder the agent can manipulate files from.
+     * @throws If projectPath does not exist or is not a directory.
+     */
+    static create(projectPath: string): Promise<Workspace>;
+}

package/dist/workspace.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+/**
+ * Validated project path with normalization.
+ *
+ * A convenience class for async path validation + normalization.
+ */
+export class Workspace {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Creates a validated Workspace.
+     * @param projectPath - Project folder the agent can manipulate files from.
+     * @throws If projectPath does not exist or is not a directory.
+     */
+    static async create(projectPath) {
+        const absPath = await validateFolder(projectPath);
+        return new Workspace(absPath);
+    }
+}
+async function validateFolder(folder) {
+    const absFolder = toAbsolutePath(folder);
+    try {
+        const stats = await fs.promises.stat(absFolder);
+        if (!stats.isDirectory()) {
+            throw new Error(`Path exists but is not a directory: "${absFolder}"`);
+        }
+        return await fs.promises.realpath(absFolder);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            throw new Error(`Directory not found: "${absFolder}"`, { cause: err });
+        }
+        throw err;
+    }
+}
+function toAbsolutePath(pathValue) {
+    // Convert slashes to platform specific slashes and then convert to absolute path
+    pathValue = pathValue.replace(/[\\/]/g, path.sep);
+    return path.resolve(pathValue);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACT,WAAW,CAAS;IAE7B,YAAoB,WAAmB;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAmB;QACnC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACJ;AAED,KAAK,UAAU,cAAc,CAAC,MAAc;IACxC,MAAM,SAAS,GAAW,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACrC,iFAAiF;IACjF,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@salesforce/sfdx-agent-sdk",
+  "version": "0.1.0",
+  "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forcedotcom/agentic-dx.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean",
+    "clean:all": "npm run clean && rimraf node_modules",
+    "postclean": "rimraf coverage && rimraf dist",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "showcoverage": "open ./coverage/lcov-report/index.html",
+    "test": "tsc --build ./test/tsconfig.json && vitest run --coverage",
+    "test:e2e": "tsc --build ./test/tsconfig.json && vitest run -c ./test/e2e/vitest.config.ts",
+    "test:e2e:local": "node scripts/local-e2e.mjs",
+    "test:e2e:local:cleanup": "node scripts/local-e2e-cleanup.mjs",
+    "verify": "tsx scripts/verify.ts"
+  },
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "files": [
+    "dist",
+    "LICENSE.txt"
+  ],
+  "dependencies": {
+    "@salesforce/agentic-common": "0.1.0",
+    "@salesforce/llm-gateway-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@salesforce/sfdx-agent-harness-mastra": "0.1.0",
+    "@types/node": "^22.19.17",
+    "@vitest/coverage-istanbul": "^4.1.5",
+    "@vitest/eslint-plugin": "^1.6.16",
+    "eslint": "^10.2.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^18.0.1",
+    "globals": "^17.6.0",
+    "lint-staged": "^17.0.4",
+    "prettier": "^3.8.3",
+    "rimraf": "^6.1.3",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.1",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,json,md}": [
+      "prettier --write"
+    ]
+  }
+}