@databricks/sdk-core 0.0.0-dev → 0.1.0-dev.2

package/dist/apierror/details.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Defines structured error detail types for API errors.
+ *
+ * @packageDocumentation
+ */
+/**
+ * ErrorDetails contains the error details of an API error. It is the union of
+ * known error details types and unknown details.
+ */
+export interface ErrorDetails {
+    errorInfo?: ErrorInfo;
+    requestInfo?: RequestInfo;
+    retryInfo?: RetryInfo;
+    debugInfo?: DebugInfo;
+    quotaFailure?: QuotaFailure;
+    preconditionFailure?: PreconditionFailure;
+    badRequest?: BadRequest;
+    resourceInfo?: ResourceInfo;
+    help?: Help;
+    /**
+     * UnknownDetails contains error details that cannot be parsed into one of
+     * the known types above.
+     */
+    unknownDetails: unknown[];
+}
+/** ErrorInfo describes the cause of the error with structured details. */
+export interface ErrorInfo {
+    /**
+     * The reason of the error. This is a constant value that identifies the
+     * proximate cause of the error.
+     */
+    reason: string;
+    /** The logical grouping to which the "reason" belongs. */
+    domain: string;
+    /** Additional structured details about this error. */
+    metadata: Record<string, string>;
+}
+/**
+ * RequestInfo contains metadata about the request that clients can attach when
+ * filing a bug or providing other forms of feedback.
+ */
+export interface RequestInfo {
+    /**
+     * An opaque string that should only be interpreted by the service that
+     * generated it. For example, it can be used to identify requests in the
+     * service's logs.
+     */
+    requestId: string;
+    /**
+     * Any data that was used to serve this request. For example, an encrypted
+     * stack trace that can be sent back to the service provider for debugging.
+     */
+    servingData: string;
+}
+/**
+ * RetryInfo describes when the clients can retry a failed request. Clients
+ * could ignore the recommendation here or retry when this information is
+ * missing from error responses.
+ *
+ * It's always recommended that clients should use exponential backoff when
+ * retrying.
+ *
+ * Clients should wait until `retryDelayMs` amount of time has passed since
+ * receiving the error response before retrying. If retrying requests also
+ * fail, clients should use an exponential backoff scheme to gradually increase
+ * the delay between retries based on `retryDelayMs`, until either a maximum
+ * number of retries have been reached or a maximum retry delay cap has been
+ * reached.
+ */
+export interface RetryInfo {
+    /** Clients should wait at least this long between retrying the same request, in milliseconds. */
+    retryDelayMs: number;
+}
+/** Describes additional debugging info. */
+export interface DebugInfo {
+    /** The stack trace entries indicating where the error occurred. */
+    stackEntries: string[];
+    /** Additional debugging information provided by the server. */
+    detail: string;
+}
+/**
+ * Describes how a quota check failed.
+ *
+ * For example if a daily limit was exceeded for the calling project,
+ * a service could respond with a QuotaFailure detail containing the project
+ * id and the description of the quota limit that was exceeded. If the
+ * calling project hasn't enabled the service in the developer console, then
+ * a service could respond with the project id and set `service_disabled`
+ * to true.
+ *
+ * Also see RetryInfo and Help types for other details about handling a
+ * quota failure.
+ */
+export interface QuotaFailure {
+    /** Describes all quota violations. */
+    violations: QuotaFailureViolation[];
+}
+export interface QuotaFailureViolation {
+    /** The subject on which the quota check failed. */
+    subject: string;
+    /**
+     * A description of how the quota check failed. Clients can use this
+     * description to find more about the quota configuration in the service's
+     * public documentation, or find the relevant quota limit to adjust through
+     * developer console.
+     *
+     * For example: "Service disabled" or "Daily Limit for read operations
+     * exceeded".
+     */
+    description: string;
+}
+/** Describes what preconditions have failed. */
+export interface PreconditionFailure {
+    /** Describes all precondition violations. */
+    violations: PreconditionFailureViolation[];
+}
+export interface PreconditionFailureViolation {
+    /** The type of PreconditionFailure. */
+    type: string;
+    /** The subject, relative to the type, that failed. */
+    subject: string;
+    /**
+     * A description of how the precondition failed. Developers can use this
+     * description to understand how to fix the failure.
+     *
+     * For example: "Terms of service not accepted".
+     */
+    description: string;
+}
+/**
+ * Describes violations in a client request. This error type focuses on the
+ * syntactic aspects of the request.
+ */
+export interface BadRequest {
+    fieldViolations: BadRequestFieldViolation[];
+}
+export interface BadRequestFieldViolation {
+    /** A path leading to a field in the request body. */
+    field: string;
+    /** A description of why the request element is bad. */
+    description: string;
+}
+/** Describes the resource that is being accessed. */
+export interface ResourceInfo {
+    /** A name for the type of resource being accessed. */
+    resourceType: string;
+    /** The name of the resource being accessed. */
+    resourceName: string;
+    /** The owner of the resource (optional). */
+    owner: string;
+    /** Describes what error is encountered when accessing this resource. */
+    description: string;
+}
+/**
+ * Provides links to documentation or for performing an out of band action.
+ *
+ * For example, if a quota check failed with an error indicating the calling
+ * project hasn't enabled the accessed service, this can contain a URL pointing
+ * directly to the right place in the developer console to flip the bit.
+ */
+export interface Help {
+    /** URL(s) pointing to additional information on handling the current error. */
+    links: HelpLink[];
+}
+export interface HelpLink {
+    /** Describes what the link offers. */
+    description: string;
+    /** The URL of the link. */
+    url: string;
+}
+/**
+ * Parses an array of raw error detail values into a structured ErrorDetails
+ * object. If multiple details of the same known type are present, the last
+ * one wins.
+ */
+export declare function parseErrorDetails(rawDetails: unknown[]): ErrorDetails;
+//# sourceMappingURL=details.d.ts.map

package/dist/apierror/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../src/apierror/details.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;OAGG;IACH,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,SAAS;IACxB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;OAQG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,UAAU,EAAE,4BAA4B,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,wBAAwB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IAEd,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,IAAI;IACnB,+EAA+E;IAC/E,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AA8OD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,YAAY,CAiBrE"}

package/dist/apierror/details.js

@@ -0,0 +1,250 @@
+/**
+ * Defines structured error detail types for API errors.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Zod schemas for the wire format (snake_case JSON from the API).
+//
+// Each schema validates the snake_case wire format from the API and transforms
+// it into the camelCase TypeScript interface. Nullish fields default to their
+// zero values (empty string, empty array, empty record) when absent or null.
+// ---------------------------------------------------------------------------
+// Reusable schema fragments. Nullish fields default to their zero values
+// (empty string, empty array, empty record) when absent or null.
+const nullishString = z
+    .string()
+    .nullish()
+    .transform(v => v ?? '');
+const errorInfoSchema = z.object({
+    reason: nullishString,
+    domain: nullishString,
+    metadata: z
+        .record(z.string(), z.string())
+        .nullish()
+        .transform(v => v ?? {}),
+});
+const requestInfoSchema = z
+    .object({
+    request_id: nullishString,
+    serving_data: nullishString,
+})
+    .transform(d => ({
+    requestId: d.request_id,
+    servingData: d.serving_data,
+}));
+// Parses a protobuf Duration string (e.g. "42.000000001s") into milliseconds.
+// Null/undefined defaults to 0. Invalid format causes a Zod validation failure.
+const nullishProtoDuration = z
+    .string()
+    .nullish()
+    .transform((v, ctx) => {
+    if (v === null || v === undefined) {
+        return 0;
+    }
+    const ms = parseProtoDuration(v);
+    if (ms === undefined) {
+        ctx.addIssue({ code: 'custom', message: 'Invalid protobuf duration.' });
+        return z.NEVER;
+    }
+    return ms;
+});
+const retryInfoSchema = z
+    .object({
+    retry_delay: nullishProtoDuration,
+})
+    .transform(d => ({
+    retryDelayMs: d.retry_delay,
+}));
+const debugInfoSchema = z
+    .object({
+    stack_entries: z
+        .array(z.string())
+        .nullish()
+        .transform(v => v ?? []),
+    detail: nullishString,
+})
+    .transform(d => ({
+    stackEntries: d.stack_entries,
+    detail: d.detail,
+}));
+const quotaViolationSchema = z.object({
+    subject: nullishString,
+    description: nullishString,
+});
+const quotaFailureSchema = z.object({
+    violations: z
+        .array(quotaViolationSchema)
+        .nullish()
+        .transform(v => v ?? []),
+});
+const preconditionViolationSchema = z.object({
+    type: nullishString,
+    subject: nullishString,
+    description: nullishString,
+});
+const preconditionFailureSchema = z.object({
+    violations: z
+        .array(preconditionViolationSchema)
+        .nullish()
+        .transform(v => v ?? []),
+});
+const fieldViolationSchema = z.object({
+    field: nullishString,
+    description: nullishString,
+});
+const badRequestSchema = z
+    .object({
+    field_violations: z
+        .array(fieldViolationSchema)
+        .nullish()
+        .transform(v => v ?? []),
+})
+    .transform(d => ({
+    fieldViolations: d.field_violations,
+}));
+const resourceInfoSchema = z
+    .object({
+    resource_type: nullishString,
+    resource_name: nullishString,
+    owner: nullishString,
+    description: nullishString,
+})
+    .transform(d => ({
+    resourceType: d.resource_type,
+    resourceName: d.resource_name,
+    owner: d.owner,
+    description: d.description,
+}));
+const helpLinkSchema = z.object({
+    description: nullishString,
+    url: nullishString,
+});
+const helpSchema = z.object({
+    links: z
+        .array(helpLinkSchema)
+        .nullish()
+        .transform(v => v ?? []),
+});
+// Google RPC type URLs used to identify error detail types in the wire format.
+const ERROR_INFO_TYPE = 'type.googleapis.com/google.rpc.ErrorInfo';
+const REQUEST_INFO_TYPE = 'type.googleapis.com/google.rpc.RequestInfo';
+const RETRY_INFO_TYPE = 'type.googleapis.com/google.rpc.RetryInfo';
+const DEBUG_INFO_TYPE = 'type.googleapis.com/google.rpc.DebugInfo';
+const QUOTA_FAILURE_TYPE = 'type.googleapis.com/google.rpc.QuotaFailure';
+const PRECONDITION_FAILURE_TYPE = 'type.googleapis.com/google.rpc.PreconditionFailure';
+const BAD_REQUEST_TYPE = 'type.googleapis.com/google.rpc.BadRequest';
+const RESOURCE_INFO_TYPE = 'type.googleapis.com/google.rpc.ResourceInfo';
+const HELP_TYPE = 'type.googleapis.com/google.rpc.Help';
+// Checks whether a value is a plain object (not null, not an array).
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// Parses a protobuf Duration string (e.g. "42.000000001s") into milliseconds.
+// Returns undefined if the format is invalid.
+function parseProtoDuration(s) {
+    if (!s.endsWith('s')) {
+        return undefined;
+    }
+    const seconds = Number(s.slice(0, -1));
+    if (Number.isNaN(seconds)) {
+        return undefined;
+    }
+    return seconds * 1000;
+}
+// Attempts to parse a single detail and assign it to the right ErrorDetails
+// field. Returns true if the detail was recognized and valid, false otherwise.
+function tryAssignDetail(ed, type, raw) {
+    switch (type) {
+        case ERROR_INFO_TYPE: {
+            const r = errorInfoSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.errorInfo = r.data;
+            return true;
+        }
+        case REQUEST_INFO_TYPE: {
+            const r = requestInfoSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.requestInfo = r.data;
+            return true;
+        }
+        case RETRY_INFO_TYPE: {
+            const r = retryInfoSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.retryInfo = r.data;
+            return true;
+        }
+        case DEBUG_INFO_TYPE: {
+            const r = debugInfoSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.debugInfo = r.data;
+            return true;
+        }
+        case QUOTA_FAILURE_TYPE: {
+            const r = quotaFailureSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.quotaFailure = r.data;
+            return true;
+        }
+        case PRECONDITION_FAILURE_TYPE: {
+            const r = preconditionFailureSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.preconditionFailure = r.data;
+            return true;
+        }
+        case BAD_REQUEST_TYPE: {
+            const r = badRequestSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.badRequest = r.data;
+            return true;
+        }
+        case RESOURCE_INFO_TYPE: {
+            const r = resourceInfoSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.resourceInfo = r.data;
+            return true;
+        }
+        case HELP_TYPE: {
+            const r = helpSchema.safeParse(raw);
+            if (!r.success)
+                return false;
+            ed.help = r.data;
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Parses an array of raw error detail values into a structured ErrorDetails
+ * object. If multiple details of the same known type are present, the last
+ * one wins.
+ */
+export function parseErrorDetails(rawDetails) {
+    const ed = { unknownDetails: [] };
+    for (const rd of rawDetails) {
+        if (!isRecord(rd)) {
+            ed.unknownDetails.push(rd);
+            continue;
+        }
+        const type = rd['@type'];
+        if (typeof type !== 'string') {
+            ed.unknownDetails.push(rd);
+            continue;
+        }
+        if (!tryAssignDetail(ed, type, rd)) {
+            ed.unknownDetails.push(rd);
+        }
+    }
+    return ed;
+}
+//# sourceMappingURL=details.js.map

package/dist/apierror/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../src/apierror/details.ts"],"names":[],"mappings":"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"}

package/dist/apierror/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Databricks API error types.
+ *
+ * @packageDocumentation
+ */
+export { ApiError } from './apierror';
+export type { ErrorDetails, ErrorInfo, RequestInfo, RetryInfo, DebugInfo, QuotaFailure, QuotaFailureViolation, PreconditionFailure, PreconditionFailureViolation, BadRequest, BadRequestFieldViolation, ResourceInfo, Help, HelpLink, } from './details';
+//# sourceMappingURL=index.d.ts.map

package/dist/apierror/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/apierror/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,UAAU,EACV,wBAAwB,EACxB,YAAY,EACZ,IAAI,EACJ,QAAQ,GACT,MAAM,WAAW,CAAC"}

package/dist/apierror/index.js

@@ -0,0 +1,7 @@
+/**
+ * Databricks API error types.
+ *
+ * @packageDocumentation
+ */
+export { ApiError } from './apierror';
+//# sourceMappingURL=index.js.map

package/dist/apierror/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apierror/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC"}

package/dist/clientinfo/agent.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Detects the AI coding agent (e.g. Claude Code, Cursor, Gemini CLI) that
+ * is running the current Node.js process. The detected product name is
+ * appended to the user-agent header so that Databricks can understand
+ * which agents are invoking the SDK.
+ *
+ * The agent list and precedence rules are kept in sync across the Go,
+ * Java, Python, and TypeScript SDKs.
+ *
+ * @module
+ */
+/**
+ * Checks environment variables for known AI agents and returns the
+ * detected product name.
+ *
+ * Explicit product-specific env vars always take precedence over the
+ * generic agents.md `AGENT` env var. `AGENT` is consulted only as a
+ * fallback when no explicit matcher fires, so that an explicit signal
+ * (e.g. `CLAUDECODE=1`) always wins over a conflicting `AGENT=<name>`
+ * value.
+ *
+ * Returns:
+ *
+ * - The product name when exactly one known env var is set.
+ * - `"multiple"` when multiple known env vars are set. Agent env vars
+ *   can be stacked when one agent invokes another as a subagent (e.g.
+ *   Claude Code spawning a Cursor CLI subprocess), so the child process
+ *   inherits env vars from multiple layers.
+ * - When no known env var is set and `AGENT` is a non-empty value: the
+ *   value itself if it names a known product, otherwise `"unknown"`.
+ * - `""` when nothing is set.
+ */
+export declare function lookupAgentProvider(): string;
+/**
+ * Returns the detected AI agent name, cached for the process lifetime.
+ *
+ * Returns one of:
+ *
+ * - The known product name when exactly one agent is detected via
+ *   explicit env matchers, or when `AGENT` is set to a known product
+ *   name and no explicit matcher fired.
+ * - `"multiple"` when multiple explicit matchers fire for different
+ *   agents (typically nested agents, e.g. Cursor CLI running as a
+ *   Claude Code subagent).
+ * - `"unknown"` when no explicit matcher fired and `AGENT` is set to a
+ *   value that is not a known product name.
+ * - `""` when no agent is detected.
+ */
+export declare function agentProvider(): string;
+/**
+ * Clears the cached agent detection result so that the next call to
+ * {@link agentProvider} re-evaluates the environment. Exported for
+ * testing only.
+ */
+export declare function clearAgentCache(): void;
+//# sourceMappingURL=agent.d.ts.map

package/dist/clientinfo/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/clientinfo/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgDH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAc5C;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/clientinfo/agent.js

@@ -0,0 +1,114 @@
+/**
+ * Detects the AI coding agent (e.g. Claude Code, Cursor, Gemini CLI) that
+ * is running the current Node.js process. The detected product name is
+ * appended to the user-agent header so that Databricks can understand
+ * which agents are invoking the SDK.
+ *
+ * The agent list and precedence rules are kept in sync across the Go,
+ * Java, Python, and TypeScript SDKs.
+ *
+ * @module
+ */
+// Name of the agents.md standard env var. When set to a value that no
+// known agent recognizes, detection falls back to "unknown".
+const AGENT_ENV_VAR = 'AGENT';
+// Canonical list of AI coding agents. Keep this list in sync with the
+// Go, Java, and Python SDKs. Agents are listed alphabetically by product
+// name.
+const KNOWN_AGENTS = [
+    // The amp agent also sets AGENT=amp, handled by the central fallback.
+    { envVar: 'AMP_CURRENT_THREAD_ID', product: 'amp' },
+    { envVar: 'ANTIGRAVITY_AGENT', product: 'antigravity' },
+    { envVar: 'AUGMENT_AGENT', product: 'augment' },
+    { envVar: 'CLAUDECODE', product: 'claude-code' },
+    { envVar: 'CLINE_ACTIVE', product: 'cline' },
+    { envVar: 'CODEX_CI', product: 'codex' },
+    { envVar: 'COPILOT_CLI', product: 'copilot-cli' },
+    { envVar: 'CURSOR_AGENT', product: 'cursor' },
+    { envVar: 'GEMINI_CLI', product: 'gemini-cli' },
+    // The goose agent also sets AGENT=goose, handled by the central
+    // fallback.
+    { envVar: 'GOOSE_TERMINAL', product: 'goose' },
+    { envVar: 'KIRO', product: 'kiro' },
+    { envVar: 'OPENCLAW_SHELL', product: 'openclaw' },
+    { envVar: 'OPENCODE', product: 'opencode' },
+    // Set by VS Code 1.121+ for agent-initiated terminal commands
+    // (https://code.visualstudio.com/updates/v1_121).
+    { envVar: 'VSCODE_AGENT', product: 'vscode-agent' },
+    { envVar: 'WINDSURF_AGENT', product: 'windsurf' },
+];
+function agentEnvFallback() {
+    const v = process.env[AGENT_ENV_VAR];
+    if (v === undefined || v === '') {
+        return '';
+    }
+    if (KNOWN_AGENTS.some(a => a.product === v)) {
+        return v;
+    }
+    return 'unknown';
+}
+/**
+ * Checks environment variables for known AI agents and returns the
+ * detected product name.
+ *
+ * Explicit product-specific env vars always take precedence over the
+ * generic agents.md `AGENT` env var. `AGENT` is consulted only as a
+ * fallback when no explicit matcher fires, so that an explicit signal
+ * (e.g. `CLAUDECODE=1`) always wins over a conflicting `AGENT=<name>`
+ * value.
+ *
+ * Returns:
+ *
+ * - The product name when exactly one known env var is set.
+ * - `"multiple"` when multiple known env vars are set. Agent env vars
+ *   can be stacked when one agent invokes another as a subagent (e.g.
+ *   Claude Code spawning a Cursor CLI subprocess), so the child process
+ *   inherits env vars from multiple layers.
+ * - When no known env var is set and `AGENT` is a non-empty value: the
+ *   value itself if it names a known product, otherwise `"unknown"`.
+ * - `""` when nothing is set.
+ */
+export function lookupAgentProvider() {
+    const matches = [];
+    for (const a of KNOWN_AGENTS) {
+        if (a.envVar in process.env) {
+            matches.push(a.product);
+        }
+    }
+    if (matches.length === 1) {
+        return matches[0];
+    }
+    if (matches.length > 1) {
+        return 'multiple';
+    }
+    return agentEnvFallback();
+}
+let cached;
+/**
+ * Returns the detected AI agent name, cached for the process lifetime.
+ *
+ * Returns one of:
+ *
+ * - The known product name when exactly one agent is detected via
+ *   explicit env matchers, or when `AGENT` is set to a known product
+ *   name and no explicit matcher fired.
+ * - `"multiple"` when multiple explicit matchers fire for different
+ *   agents (typically nested agents, e.g. Cursor CLI running as a
+ *   Claude Code subagent).
+ * - `"unknown"` when no explicit matcher fired and `AGENT` is set to a
+ *   value that is not a known product name.
+ * - `""` when no agent is detected.
+ */
+export function agentProvider() {
+    cached ??= lookupAgentProvider();
+    return cached;
+}
+/**
+ * Clears the cached agent detection result so that the next call to
+ * {@link agentProvider} re-evaluates the environment. Exported for
+ * testing only.
+ */
+export function clearAgentCache() {
+    cached = undefined;
+}
+//# sourceMappingURL=agent.js.map

package/dist/clientinfo/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/clientinfo/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,sEAAsE;AACtE,6DAA6D;AAC7D,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,sEAAsE;AACtE,yEAAyE;AACzE,QAAQ;AACR,MAAM,YAAY,GAA0B;IAC1C,sEAAsE;IACtE,EAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,KAAK,EAAC;IACjD,EAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,aAAa,EAAC;IACrD,EAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAC;IAC7C,EAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAC;IAC9C,EAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAC;IAC1C,EAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAC;IACtC,EAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAC;IAC/C,EAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAC;IAC3C,EAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAC;IAC7C,gEAAgE;IAChE,YAAY;IACZ,EAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAC;IAC5C,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAC;IACjC,EAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAC;IAC/C,EAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAC;IACzC,8DAA8D;IAC9D,kDAAkD;IAClD,EAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAC;IACjD,EAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAC;CAChD,CAAC;AAEF,SAAS,gBAAgB;IACvB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,IAAI,MAA0B,CAAC;AAE/B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,mBAAmB,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC"}