@cadenya/cadenya 0.135.0 → 1.0.0

package/resources/workspaces.d.ts

@@ -1,70 +0,0 @@
-import { APIResource } from "../core/resource.js";
-import * as Shared from "./shared.js";
-import { CursorPagination, type CursorPaginationParams, PagePromise } from "../core/pagination.js";
-import { RequestOptions } from "../internal/request-options.js";
-/**
- * Manage workspaces within an account. Workspaces provide organizational
- *  grouping and isolation for resources such as agents, tools, and API keys.
- *
- *  This is the workspace-scoped, end-user surface. Administrative operations
- *  (create / archive workspaces, manage members) live in WorkspaceAdminService
- *  under /v1/account/workspaces and require the admin role.
- */
-export declare class Workspaces extends APIResource {
-    /**
-     * Lists all workspaces for the current account
-     */
-    list(query?: WorkspaceListParams | null | undefined, options?: RequestOptions): PagePromise<WorkspacesCursorPagination, Workspace>;
-}
-export type WorkspacesCursorPagination = CursorPagination<Workspace>;
-export interface Workspace {
-    /**
-     * AccountResourceMetadata is used to represent a resource that is associated to an
-     * account but not to a workspace.
-     */
-    metadata: Shared.AccountResourceMetadata;
-    spec: WorkspaceSpec;
-    /**
-     * WorkspaceInfo returns counts
-     */
-    info?: Workspace.Info;
-    /**
-     * Lifecycle status of the workspace. Archived workspaces reject all requests
-     * scoped to them. Server-populated.
-     */
-    status?: 'STATUS_ENABLED' | 'STATUS_DISABLED' | 'STATUS_ARCHIVED';
-}
-export declare namespace Workspace {
-    /**
-     * WorkspaceInfo returns counts
-     */
-    interface Info {
-        totalAgents?: number;
-        totalAgentVariations?: number;
-        totalAvailableTools?: number;
-        totalMemoryEntries?: number;
-    }
-}
-export interface WorkspaceSpec {
-    description?: string;
-}
-export interface WorkspaceListParams extends CursorPaginationParams {
-    /**
-     * When set to true you may use more of your alloted API rate-limit
-     */
-    includeInfo?: boolean;
-    /**
-     * Filters by metadata labels. Comma-separated key=value pairs, e.g.
-     * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
-     * semantics).
-     */
-    labels?: string;
-    /**
-     * Sort order for results (asc or desc by creation time)
-     */
-    sortOrder?: string;
-}
-export declare namespace Workspaces {
-    export { type Workspace as Workspace, type WorkspaceSpec as WorkspaceSpec, type WorkspacesCursorPagination as WorkspacesCursorPagination, type WorkspaceListParams as WorkspaceListParams, };
-}
-//# sourceMappingURL=workspaces.d.ts.map

package/resources/workspaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/resources/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,MAAM,oBAAiB;AACnC,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,WAAW,EAAE,8BAA2B;AAChG,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,0BAA0B,EAAE,SAAS,CAAC;CAGtD;AAED,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,uBAAuB,CAAC;IAEzC,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;CACnE;AAED,yBAAiB,SAAS,CAAC;IACzB;;OAEG;IACH,UAAiB,IAAI;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAE7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/workspaces.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Workspaces = void 0;
-const resource_1 = require("../core/resource.js");
-const pagination_1 = require("../core/pagination.js");
-/**
- * Manage workspaces within an account. Workspaces provide organizational
- *  grouping and isolation for resources such as agents, tools, and API keys.
- *
- *  This is the workspace-scoped, end-user surface. Administrative operations
- *  (create / archive workspaces, manage members) live in WorkspaceAdminService
- *  under /v1/account/workspaces and require the admin role.
- */
-class Workspaces extends resource_1.APIResource {
-    /**
-     * Lists all workspaces for the current account
-     */
-    list(query = {}, options) {
-        return this._client.getAPIList('/v1/workspaces', (pagination_1.CursorPagination), { query, ...options });
-    }
-}
-exports.Workspaces = Workspaces;
-//# sourceMappingURL=workspaces.js.map

package/resources/workspaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../src/resources/workspaces.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAE/C,sDAAgG;AAGhG;;;;;;;GAOG;AACH,MAAa,UAAW,SAAQ,sBAAW;IACzC;;OAEG;IACH,IAAI,CACF,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,6BAA2B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;CACF;AAVD,gCAUC"}

package/resources/workspaces.mjs

@@ -1,19 +0,0 @@
-import { APIResource } from "../core/resource.mjs";
-import { CursorPagination } from "../core/pagination.mjs";
-/**
- * Manage workspaces within an account. Workspaces provide organizational
- *  grouping and isolation for resources such as agents, tools, and API keys.
- *
- *  This is the workspace-scoped, end-user surface. Administrative operations
- *  (create / archive workspaces, manage members) live in WorkspaceAdminService
- *  under /v1/account/workspaces and require the admin role.
- */
-export class Workspaces extends APIResource {
-    /**
-     * Lists all workspaces for the current account
-     */
-    list(query = {}, options) {
-        return this._client.getAPIList('/v1/workspaces', (CursorPagination), { query, ...options });
-    }
-}
-//# sourceMappingURL=workspaces.mjs.map

package/resources/workspaces.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.mjs","sourceRoot":"","sources":["../src/resources/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,gBAAgB,EAA4C,+BAA2B;AAGhG;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;OAEG;IACH,IAAI,CACF,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,gBAA2B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;CACF"}

package/resources.d.mts

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

package/resources.d.mts.map

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

package/resources.d.ts

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

package/resources.d.ts.map

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

package/resources.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("./internal/tslib.js");
-tslib_1.__exportStar(require("./resources/index.js"), exports);
-//# sourceMappingURL=resources.js.map

package/resources.js.map

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

package/resources.mjs

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

package/resources.mjs.map

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

package/src/api-promise.ts

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

package/src/core/README.md

@@ -1,3 +0,0 @@
-# `core`
-
-This directory holds public modules implementing non-resource-specific SDK functionality.

package/src/core/api-promise.ts

@@ -1,90 +0,0 @@
-import { type Cadenya } from '../client';
-
-import { type PromiseOrValue } from '../internal/types';
-import { APIResponseProps, defaultParseResponse } from '../internal/parse';
-
-/**
- * A subclass of `Promise` providing additional helper methods
- * for interacting with the SDK.
- */
-export class APIPromise<T> extends Promise<T> {
-  private parsedPromise: Promise<T> | undefined;
-  #client: Cadenya;
-
-  constructor(
-    client: Cadenya,
-    private responsePromise: Promise<APIResponseProps>,
-    private parseResponse: (
-      client: Cadenya,
-      props: APIResponseProps,
-    ) => PromiseOrValue<T> = defaultParseResponse,
-  ) {
-    super((resolve) => {
-      // this is maybe a bit weird but this has to be a no-op to not implicitly
-      // parse the response body; instead .then, .catch, .finally are overridden
-      // to parse the response
-      resolve(null as any);
-    });
-    this.#client = client;
-  }
-
-  _thenUnwrap<U>(transform: (data: T, props: APIResponseProps) => U): APIPromise<U> {
-    return new APIPromise(this.#client, this.responsePromise, async (client, props) =>
-      transform(await this.parseResponse(client, props), props),
-    );
-  }
-
-  /**
-   * Gets the raw `Response` instance instead of parsing the response
-   * data.
-   *
-   * If you want to parse the response body but still get the `Response`
-   * instance, you can use {@link withResponse()}.
-   *
-   * 👋 Getting the wrong TypeScript type for `Response`?
-   * Try setting `"moduleResolution": "NodeNext"` or add `"lib": ["DOM"]`
-   * to your `tsconfig.json`.
-   */
-  asResponse(): Promise<Response> {
-    return this.responsePromise.then((p) => p.response);
-  }
-
-  /**
-   * Gets the parsed response data and the raw `Response` instance.
-   *
-   * If you just want to get the raw `Response` instance without parsing it,
-   * you can use {@link asResponse()}.
-   *
-   * 👋 Getting the wrong TypeScript type for `Response`?
-   * Try setting `"moduleResolution": "NodeNext"` or add `"lib": ["DOM"]`
-   * to your `tsconfig.json`.
-   */
-  async withResponse(): Promise<{ data: T; response: Response }> {
-    const [data, response] = await Promise.all([this.parse(), this.asResponse()]);
-    return { data, response };
-  }
-
-  private parse(): Promise<T> {
-    if (!this.parsedPromise) {
-      this.parsedPromise = this.responsePromise.then((data) => this.parseResponse(this.#client, data));
-    }
-    return this.parsedPromise;
-  }
-
-  override then<TResult1 = T, TResult2 = never>(
-    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null,
-    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null,
-  ): Promise<TResult1 | TResult2> {
-    return this.parse().then(onfulfilled, onrejected);
-  }
-
-  override catch<TResult = never>(
-    onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null,
-  ): Promise<T | TResult> {
-    return this.parse().catch(onrejected);
-  }
-
-  override finally(onfinally?: (() => void) | undefined | null): Promise<T> {
-    return this.parse().finally(onfinally);
-  }
-}

package/src/core/resource.ts

@@ -1,9 +0,0 @@
-import type { Cadenya } from '../client';
-
-export abstract class APIResource {
-  protected _client: Cadenya;
-
-  constructor(client: Cadenya) {
-    this._client = client;
-  }
-}

package/src/core/streaming.ts

@@ -1,319 +0,0 @@
-import { CadenyaError } from './error';
-import { type ReadableStream } from '../internal/shim-types';
-import { makeReadableStream } from '../internal/shims';
-import { findDoubleNewlineIndex, LineDecoder } from '../internal/decoders/line';
-import { ReadableStreamToAsyncIterable } from '../internal/shims';
-import { isAbortError } from '../internal/errors';
-import { encodeUTF8 } from '../internal/utils/bytes';
-import { loggerFor } from '../internal/utils/log';
-import type { Cadenya } from '../client';
-
-type Bytes = string | ArrayBuffer | Uint8Array | null | undefined;
-
-export type ServerSentEvent = {
-  event: string | null;
-  data: string;
-  raw: string[];
-};
-
-export class Stream<Item> implements AsyncIterable<Item> {
-  controller: AbortController;
-  #client: Cadenya | undefined;
-
-  constructor(
-    private iterator: () => AsyncIterator<Item>,
-    controller: AbortController,
-    client?: Cadenya,
-  ) {
-    this.controller = controller;
-    this.#client = client;
-  }
-
-  static fromSSEResponse<Item>(
-    response: Response,
-    controller: AbortController,
-    client?: Cadenya,
-  ): Stream<Item> {
-    let consumed = false;
-    const logger = client ? loggerFor(client) : console;
-
-    async function* iterator(): AsyncIterator<Item, any, undefined> {
-      if (consumed) {
-        throw new CadenyaError('Cannot iterate over a consumed stream, use `.tee()` to split the stream.');
-      }
-      consumed = true;
-      let done = false;
-      try {
-        for await (const sse of _iterSSEMessages(response, controller)) {
-          if (sse.event === 'open' || sse.event === 'ping') {
-            continue;
-          } else {
-            try {
-              yield JSON.parse(sse.data) as Item;
-            } catch (e) {
-              logger.error(`Could not parse message into JSON:`, sse.data);
-              logger.error(`From chunk:`, sse.raw);
-              throw e;
-            }
-          }
-        }
-        done = true;
-      } catch (e) {
-        // If the user calls `stream.controller.abort()`, we should exit without throwing.
-        if (isAbortError(e)) return;
-        throw e;
-      } finally {
-        // If the user `break`s, abort the ongoing request.
-        if (!done) controller.abort();
-      }
-    }
-
-    return new Stream(iterator, controller, client);
-  }
-
-  /**
-   * Generates a Stream from a newline-separated ReadableStream
-   * where each item is a JSON value.
-   */
-  static fromReadableStream<Item>(
-    readableStream: ReadableStream,
-    controller: AbortController,
-    client?: Cadenya,
-  ): Stream<Item> {
-    let consumed = false;
-
-    async function* iterLines(): AsyncGenerator<string, void, unknown> {
-      const lineDecoder = new LineDecoder();
-
-      const iter = ReadableStreamToAsyncIterable<Bytes>(readableStream);
-      for await (const chunk of iter) {
-        for (const line of lineDecoder.decode(chunk)) {
-          yield line;
-        }
-      }
-
-      for (const line of lineDecoder.flush()) {
-        yield line;
-      }
-    }
-
-    async function* iterator(): AsyncIterator<Item, any, undefined> {
-      if (consumed) {
-        throw new CadenyaError('Cannot iterate over a consumed stream, use `.tee()` to split the stream.');
-      }
-      consumed = true;
-      let done = false;
-      try {
-        for await (const line of iterLines()) {
-          if (done) continue;
-          if (line) yield JSON.parse(line) as Item;
-        }
-        done = true;
-      } catch (e) {
-        // If the user calls `stream.controller.abort()`, we should exit without throwing.
-        if (isAbortError(e)) return;
-        throw e;
-      } finally {
-        // If the user `break`s, abort the ongoing request.
-        if (!done) controller.abort();
-      }
-    }
-
-    return new Stream(iterator, controller, client);
-  }
-
-  [Symbol.asyncIterator](): AsyncIterator<Item> {
-    return this.iterator();
-  }
-
-  /**
-   * Splits the stream into two streams which can be
-   * independently read from at different speeds.
-   */
-  tee(): [Stream<Item>, Stream<Item>] {
-    const left: Array<Promise<IteratorResult<Item>>> = [];
-    const right: Array<Promise<IteratorResult<Item>>> = [];
-    const iterator = this.iterator();
-
-    const teeIterator = (queue: Array<Promise<IteratorResult<Item>>>): AsyncIterator<Item> => {
-      return {
-        next: () => {
-          if (queue.length === 0) {
-            const result = iterator.next();
-            left.push(result);
-            right.push(result);
-          }
-          return queue.shift()!;
-        },
-      };
-    };
-
-    return [
-      new Stream(() => teeIterator(left), this.controller, this.#client),
-      new Stream(() => teeIterator(right), this.controller, this.#client),
-    ];
-  }
-
-  /**
-   * Converts this stream to a newline-separated ReadableStream of
-   * JSON stringified values in the stream
-   * which can be turned back into a Stream with `Stream.fromReadableStream()`.
-   */
-  toReadableStream(): ReadableStream {
-    const self = this;
-    let iter: AsyncIterator<Item>;
-
-    return makeReadableStream({
-      async start() {
-        iter = self[Symbol.asyncIterator]();
-      },
-      async pull(ctrl: any) {
-        try {
-          const { value, done } = await iter.next();
-          if (done) return ctrl.close();
-
-          const bytes = encodeUTF8(JSON.stringify(value) + '\n');
-
-          ctrl.enqueue(bytes);
-        } catch (err) {
-          ctrl.error(err);
-        }
-      },
-      async cancel() {
-        await iter.return?.();
-      },
-    });
-  }
-}
-
-export async function* _iterSSEMessages(
-  response: Response,
-  controller: AbortController,
-): AsyncGenerator<ServerSentEvent, void, unknown> {
-  if (!response.body) {
-    controller.abort();
-    if (
-      typeof (globalThis as any).navigator !== 'undefined' &&
-      (globalThis as any).navigator.product === 'ReactNative'
-    ) {
-      throw new CadenyaError(
-        `The default react-native fetch implementation does not support streaming. Please use expo/fetch: https://docs.expo.dev/versions/latest/sdk/expo/#expofetch-api`,
-      );
-    }
-    throw new CadenyaError(`Attempted to iterate over a response with no body`);
-  }
-
-  const sseDecoder = new SSEDecoder();
-  const lineDecoder = new LineDecoder();
-
-  const iter = ReadableStreamToAsyncIterable<Bytes>(response.body);
-  for await (const sseChunk of iterSSEChunks(iter)) {
-    for (const line of lineDecoder.decode(sseChunk)) {
-      const sse = sseDecoder.decode(line);
-      if (sse) yield sse;
-    }
-  }
-
-  for (const line of lineDecoder.flush()) {
-    const sse = sseDecoder.decode(line);
-    if (sse) yield sse;
-  }
-}
-
-/**
- * Given an async iterable iterator, iterates over it and yields full
- * SSE chunks, i.e. yields when a double new-line is encountered.
- */
-async function* iterSSEChunks(iterator: AsyncIterableIterator<Bytes>): AsyncGenerator<Uint8Array> {
-  let data = new Uint8Array();
-
-  for await (const chunk of iterator) {
-    if (chunk == null) {
-      continue;
-    }
-
-    const binaryChunk =
-      chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
-      : typeof chunk === 'string' ? encodeUTF8(chunk)
-      : chunk;
-
-    let newData = new Uint8Array(data.length + binaryChunk.length);
-    newData.set(data);
-    newData.set(binaryChunk, data.length);
-    data = newData;
-
-    let patternIndex;
-    while ((patternIndex = findDoubleNewlineIndex(data)) !== -1) {
-      yield data.slice(0, patternIndex);
-      data = data.slice(patternIndex);
-    }
-  }
-
-  if (data.length > 0) {
-    yield data;
-  }
-}
-
-class SSEDecoder {
-  private data: string[];
-  private event: string | null;
-  private chunks: string[];
-
-  constructor() {
-    this.event = null;
-    this.data = [];
-    this.chunks = [];
-  }
-
-  decode(line: string) {
-    if (line.endsWith('\r')) {
-      line = line.substring(0, line.length - 1);
-    }
-
-    if (!line) {
-      // empty line and we didn't previously encounter any messages
-      if (!this.event && !this.data.length) return null;
-
-      const sse: ServerSentEvent = {
-        event: this.event,
-        data: this.data.join('\n'),
-        raw: this.chunks,
-      };
-
-      this.event = null;
-      this.data = [];
-      this.chunks = [];
-
-      return sse;
-    }
-
-    this.chunks.push(line);
-
-    if (line.startsWith(':')) {
-      return null;
-    }
-
-    let [fieldname, _, value] = partition(line, ':');
-
-    if (value.startsWith(' ')) {
-      value = value.substring(1);
-    }
-
-    if (fieldname === 'event') {
-      this.event = value;
-    } else if (fieldname === 'data') {
-      this.data.push(value);
-    }
-
-    return null;
-  }
-}
-
-function partition(str: string, delimiter: string): [string, string, string] {
-  const index = str.indexOf(delimiter);
-  if (index !== -1) {
-    return [str.substring(0, index), delimiter, str.substring(index + delimiter.length)];
-  }
-
-  return [str, '', ''];
-}

package/src/core/uploads.ts

@@ -1,2 +0,0 @@
-export { type Uploadable } from '../internal/uploads';
-export { toFile, type ToFileInput } from '../internal/to-file';

package/src/error.ts

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

package/src/internal/README.md

@@ -1,3 +0,0 @@
-# `internal`
-
-The modules in this directory are not importable outside this package and will change between releases.