warp-agent-sdk 0.2.0

package/src/internal/utils/values.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { WarpAPIError } from '../../core/error';
+
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export const isAbsoluteURL = (url: string): boolean => {
+  return startsWithSchemeRegexp.test(url);
+};
+
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x: unknown): object {
+  if (typeof x !== 'object') {
+    return {};
+  }
+
+  return x ?? {};
+}
+
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj: Object | null | undefined): boolean {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn<T extends object = object>(obj: T, key: PropertyKey): key is keyof T {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+export function isObj(obj: unknown): obj is Record<string, unknown> {
+  return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+
+export const ensurePresent = <T>(value: T | null | undefined): T => {
+  if (value == null) {
+    throw new WarpAPIError(`Expected a value to be given but received ${value} instead.`);
+  }
+
+  return value;
+};
+
+export const validatePositiveInteger = (name: string, n: unknown): number => {
+  if (typeof n !== 'number' || !Number.isInteger(n)) {
+    throw new WarpAPIError(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new WarpAPIError(`${name} must be a positive integer`);
+  }
+  return n;
+};
+
+export const coerceInteger = (value: unknown): number => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+
+  throw new WarpAPIError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceFloat = (value: unknown): number => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+
+  throw new WarpAPIError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceBoolean = (value: unknown): boolean => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+
+export const maybeCoerceInteger = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceInteger(value);
+};
+
+export const maybeCoerceFloat = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceFloat(value);
+};
+
+export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceBoolean(value);
+};
+
+export const safeJSON = (text: string) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};

package/src/internal/utils.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './utils/values';
+export * from './utils/base64';
+export * from './utils/env';
+export * from './utils/log';
+export * from './utils/uuid';
+export * from './utils/sleep';

package/src/lib/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store custom files to expand the SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/resource.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/agent/agent.ts

@@ -0,0 +1,149 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as TasksAPI from './tasks';
+import { TaskItem, TaskListParams, TaskListResponse, TaskSourceType, TaskState, Tasks } from './tasks';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Agent extends APIResource {
+  tasks: TasksAPI.Tasks = new TasksAPI.Tasks(this._client);
+
+  /**
+   * Spawn an ambient agent with a prompt and optional configuration. The agent will
+   * be queued for execution and assigned a unique task ID.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agent.run({
+   *   prompt: 'Fix the bug in auth.go',
+   * });
+   * ```
+   */
+  run(body: AgentRunParams, options?: RequestOptions): APIPromise<AgentRunResponse> {
+    return this._client.post('/agent/run', { body, ...options });
+  }
+}
+
+/**
+ * Configuration for an ambient agent task
+ */
+export interface AmbientAgentConfig {
+  /**
+   * Custom base prompt for the agent
+   */
+  base_prompt?: string;
+
+  /**
+   * UID of a CloudEnvironment GSO to use
+   */
+  environment_id?: string;
+
+  /**
+   * Map of MCP server configurations by name
+   */
+  mcp_servers?: { [key: string]: AmbientAgentConfig.McpServers };
+
+  /**
+   * LLM model to use (uses workspace default if not specified)
+   */
+  model_id?: string;
+
+  /**
+   * Config name for searchability and traceability
+   */
+  name?: string;
+}
+
+export namespace AmbientAgentConfig {
+  /**
+   * Configuration for an MCP server. Must have exactly one of: warp_id, command, or
+   * url.
+   */
+  export interface McpServers {
+    /**
+     * Stdio transport - command arguments
+     */
+    args?: Array<string>;
+
+    /**
+     * Stdio transport - command to run
+     */
+    command?: string;
+
+    /**
+     * Environment variables for the server
+     */
+    env?: { [key: string]: string };
+
+    /**
+     * HTTP headers for SSE/HTTP transport
+     */
+    headers?: { [key: string]: string };
+
+    /**
+     * SSE/HTTP transport - server URL
+     */
+    url?: string;
+
+    /**
+     * Reference to a Warp shared MCP server by UUID
+     */
+    warp_id?: string;
+  }
+}
+
+export interface AgentRunResponse {
+  /**
+   * Current state of the task:
+   *
+   * - QUEUED: Task is waiting to be picked up
+   * - PENDING: Task is being prepared
+   * - CLAIMED: Task has been claimed by a worker
+   * - INPROGRESS: Task is actively being executed
+   * - SUCCEEDED: Task completed successfully
+   * - FAILED: Task failed
+   */
+  state: TasksAPI.TaskState;
+
+  /**
+   * Unique identifier for the created task
+   */
+  task_id: string;
+}
+
+export interface AgentRunParams {
+  /**
+   * The prompt/instruction for the agent to execute
+   */
+  prompt: string;
+
+  /**
+   * Configuration for an ambient agent task
+   */
+  config?: AmbientAgentConfig;
+
+  /**
+   * Custom title for the task (auto-generated if not provided)
+   */
+  title?: string;
+}
+
+Agent.Tasks = Tasks;
+
+export declare namespace Agent {
+  export {
+    type AmbientAgentConfig as AmbientAgentConfig,
+    type AgentRunResponse as AgentRunResponse,
+    type AgentRunParams as AgentRunParams,
+  };
+
+  export {
+    Tasks as Tasks,
+    type TaskItem as TaskItem,
+    type TaskSourceType as TaskSourceType,
+    type TaskState as TaskState,
+    type TaskListResponse as TaskListResponse,
+    type TaskListParams as TaskListParams,
+  };
+}

package/src/resources/agent/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Agent, type AmbientAgentConfig, type AgentRunResponse, type AgentRunParams } from './agent';
+export {
+  Tasks,
+  type TaskItem,
+  type TaskSourceType,
+  type TaskState,
+  type TaskListResponse,
+  type TaskListParams,
+} from './tasks';

package/src/resources/agent/tasks.ts

@@ -0,0 +1,231 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentAPI from './agent';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Tasks extends APIResource {
+  /**
+   * Retrieve detailed information about a specific agent task, including the full
+   * prompt, session link, and resolved configuration.
+   *
+   * @example
+   * ```ts
+   * const taskItem = await client.agent.tasks.retrieve(
+   *   'taskId',
+   * );
+   * ```
+   */
+  retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskItem> {
+    return this._client.get(path`/agent/tasks/${taskID}`, options);
+  }
+
+  /**
+   * Retrieve a paginated list of agent tasks with optional filtering. Results are
+   * ordered by creation time (newest first).
+   *
+   * @example
+   * ```ts
+   * const tasks = await client.agent.tasks.list();
+   * ```
+   */
+  list(
+    query: TaskListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TaskListResponse> {
+    return this._client.get('/agent/tasks', { query, ...options });
+  }
+}
+
+export interface TaskItem {
+  /**
+   * Timestamp when the task was created (RFC3339)
+   */
+  created_at: string;
+
+  /**
+   * The prompt/instruction for the agent
+   */
+  prompt: string;
+
+  /**
+   * Current state of the task:
+   *
+   * - QUEUED: Task is waiting to be picked up
+   * - PENDING: Task is being prepared
+   * - CLAIMED: Task has been claimed by a worker
+   * - INPROGRESS: Task is actively being executed
+   * - SUCCEEDED: Task completed successfully
+   * - FAILED: Task failed
+   */
+  state: TaskState;
+
+  /**
+   * Unique identifier for the task
+   */
+  task_id: string;
+
+  /**
+   * Human-readable title for the task
+   */
+  title: string;
+
+  /**
+   * Timestamp when the task was last updated (RFC3339)
+   */
+  updated_at: string;
+
+  /**
+   * Configuration for an ambient agent task
+   */
+  agent_config?: AgentAPI.AmbientAgentConfig;
+
+  creator?: TaskItem.Creator;
+
+  /**
+   * UUID of the shared session (if available)
+   */
+  session_id?: string;
+
+  /**
+   * URL to view the agent session
+   */
+  session_link?: string;
+
+  /**
+   * Source that created the task:
+   *
+   * - LINEAR: Created from Linear integration
+   * - API: Created via the public API
+   * - SLACK: Created from Slack integration
+   * - LOCAL: Created from local CLI/app
+   * - SCHEDULED_AGENT: Created by a scheduled agent
+   */
+  source?: TaskSourceType;
+
+  status_message?: TaskItem.StatusMessage;
+}
+
+export namespace TaskItem {
+  export interface Creator {
+    /**
+     * Type of the creator principal
+     */
+    type?: 'user' | 'service_account';
+
+    /**
+     * Unique identifier of the creator
+     */
+    uid?: string;
+  }
+
+  export interface StatusMessage {
+    /**
+     * Human-readable status message
+     */
+    message?: string;
+  }
+}
+
+/**
+ * Source that created the task:
+ *
+ * - LINEAR: Created from Linear integration
+ * - API: Created via the public API
+ * - SLACK: Created from Slack integration
+ * - LOCAL: Created from local CLI/app
+ * - SCHEDULED_AGENT: Created by a scheduled agent
+ */
+export type TaskSourceType = 'LINEAR' | 'API' | 'SLACK' | 'LOCAL' | 'SCHEDULED_AGENT';
+
+/**
+ * Current state of the task:
+ *
+ * - QUEUED: Task is waiting to be picked up
+ * - PENDING: Task is being prepared
+ * - CLAIMED: Task has been claimed by a worker
+ * - INPROGRESS: Task is actively being executed
+ * - SUCCEEDED: Task completed successfully
+ * - FAILED: Task failed
+ */
+export type TaskState = 'QUEUED' | 'PENDING' | 'CLAIMED' | 'INPROGRESS' | 'SUCCEEDED' | 'FAILED';
+
+export interface TaskListResponse {
+  page_info: TaskListResponse.PageInfo;
+
+  tasks: Array<TaskItem>;
+}
+
+export namespace TaskListResponse {
+  export interface PageInfo {
+    /**
+     * Whether there are more results available
+     */
+    has_next_page: boolean;
+
+    /**
+     * Opaque cursor for fetching the next page
+     */
+    next_cursor?: string;
+  }
+}
+
+export interface TaskListParams {
+  /**
+   * Filter by agent config name
+   */
+  config_name?: string;
+
+  /**
+   * Filter tasks created after this timestamp (RFC3339 format)
+   */
+  created_after?: string;
+
+  /**
+   * Filter tasks created before this timestamp (RFC3339 format)
+   */
+  created_before?: string;
+
+  /**
+   * Filter by creator UID (user or service account)
+   */
+  creator?: string;
+
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of tasks to return
+   */
+  limit?: number;
+
+  /**
+   * Filter by model ID
+   */
+  model_id?: string;
+
+  /**
+   * Filter by task source type
+   */
+  source?: TaskSourceType;
+
+  /**
+   * Filter by task state. Can be specified multiple times to match any of the given
+   * states.
+   */
+  state?: Array<TaskState>;
+}
+
+export declare namespace Tasks {
+  export {
+    type TaskItem as TaskItem,
+    type TaskSourceType as TaskSourceType,
+    type TaskState as TaskState,
+    type TaskListResponse as TaskListResponse,
+    type TaskListParams as TaskListParams,
+  };
+}

package/src/resources/agent.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './agent/index';

package/src/resources/index.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Agent, type AmbientAgentConfig, type AgentRunResponse, type AgentRunParams } from './agent/agent';

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "ES2015",
+    "lib": ["DOM", "DOM.Iterable", "ES2018"],
+    "moduleResolution": "node"
+  }
+}

package/src/uploads.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/uploads instead */
+export * from './core/uploads';

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.2.0'; // x-release-please-version

package/uploads.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.js";
+//# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/uploads instead */
+tslib_1.__exportStar(require("./core/uploads.js"), exports);
+//# sourceMappingURL=uploads.js.map

package/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4DAA+B"}

package/uploads.mjs

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/version.d.mts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.2.0";
+//# sourceMappingURL=version.d.mts.map

package/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.2.0";
+//# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = '0.2.0'; // x-release-please-version
+//# sourceMappingURL=version.js.map

package/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

@@ -0,0 +1,2 @@
+export const VERSION = '0.2.0'; // x-release-please-version
+//# sourceMappingURL=version.mjs.map

package/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}