@cadenya/cadenya 0.135.0 → 1.0.0

package/src/resources/memory-entries.ts

@@ -0,0 +1,163 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { CreateResourceMetadata, ListMemoryEntriesResponse, MemoryEntry, MemoryEntryCreateSpec, MemoryEntryDetail, MemoryEntryUpdateSpec, UpdateResourceMetadata } from '../types.js';
+
+export interface MemoryEntryListParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter by key prefix (e.g., "skills/postmortem/" to list all entries
+   *  under that hierarchy). Matches against the entry's key, not its name.
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * 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;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+}
+
+export interface MemoryEntryCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: MemoryEntryCreateSpec;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryEntryRetrieveParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryEntryDeleteParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryEntryUpdateParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: MemoryEntryUpdateSpec;
+  updateMask?: string;
+}
+
+export class MemoryEntries {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List memory entries
+   * 
+   * @example
+   * ```ts
+   * const page = await client.memoryLayers.entries.list('memory_layer_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(memoryLayerId: string, params?: MemoryEntryListParams, options?: RequestOptions): Promise<Page<MemoryEntry>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListMemoryEntriesResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('memoryLayerId', memoryLayerId)}/entries`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list(memoryLayerId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new memory entry
+   * 
+   * @example
+   * ```ts
+   * const memoryEntryDetail = await client.memoryLayers.entries.create('memory_layer_123', { metadata: { name: 'sample' }, spec: { content: 'sample', key: 'sample', type: 'content' } });
+   * ```
+   */
+  create(memoryLayerId: string, params: MemoryEntryCreateParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
+    return this._client.requestAPI<MemoryEntryDetail>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('memoryLayerId', memoryLayerId)}/entries`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a memory entry by ID
+   * 
+   * @example
+   * ```ts
+   * const memoryEntryDetail = await client.memoryLayers.entries.retrieve('memory_layer_123', '_123');
+   * ```
+   */
+  retrieve(memoryLayerId: string, id: string, params?: MemoryEntryRetrieveParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
+    return this._client.requestAPI<MemoryEntryDetail>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('memoryLayerId', memoryLayerId)}/entries/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a memory entry
+   * 
+   * @example
+   * ```ts
+   * await client.memoryLayers.entries.delete('memory_layer_123', '_123');
+   * ```
+   */
+  delete(memoryLayerId: string, id: string, params?: MemoryEntryDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('memoryLayerId', memoryLayerId)}/entries/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a memory entry
+   * 
+   * @example
+   * ```ts
+   * const memoryEntryDetail = await client.memoryLayers.entries.update('memory_layer_123', '_123');
+   * ```
+   */
+  update(memoryLayerId: string, id: string, params?: MemoryEntryUpdateParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
+    return this._client.requestAPI<MemoryEntryDetail>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('memoryLayerId', memoryLayerId)}/entries/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+}

package/src/resources/memory-layers.ts

@@ -1 +1,181 @@
-export * from './memory-layers/index';
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import { MemoryEntries } from './memory-entries.js';
+import type { CreateResourceMetadata, ListMemoryLayersResponse, MemoryLayer, MemoryLayerSpecParam, MemoryServiceListMemoryLayersType, UpdateResourceMetadata } from '../types.js';
+import { wireMemoryLayerSpec } from '../types.js';
+
+export interface MemoryLayerListParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * Filter by layer type
+   */
+  type?: MemoryServiceListMemoryLayersType;
+  /**
+   * Filter to episodic layers belonging to this agent.
+   */
+  agentId?: string;
+  /**
+   * Filter to episodic layers whose episodic key starts with this prefix
+   *  (e.g. "customer/" matches "customer/42" and "customer/43"). Useful for
+   *  namespaced keys, similar to a redis key scan.
+   */
+  episodicKeyPrefix?: string;
+  /**
+   * 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;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+}
+
+export interface MemoryLayerCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: MemoryLayerSpecParam;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryLayerRetrieveParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryLayerDeleteParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface MemoryLayerUpdateParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: MemoryLayerSpecParam;
+  updateMask?: string;
+}
+
+export class MemoryLayers {
+  readonly entries: MemoryEntries;
+  constructor(private readonly _client: HttpClient) {
+    this.entries = new MemoryEntries(_client);
+  }
+
+  /**
+   * List memory layers
+   * 
+   * @example
+   * ```ts
+   * const page = await client.memoryLayers.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: MemoryLayerListParams, options?: RequestOptions): Promise<Page<MemoryLayer>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListMemoryLayersResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, type: params?.type, agentId: params?.agentId, episodicKeyPrefix: params?.episodicKeyPrefix, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new memory layer
+   * 
+   * @example
+   * ```ts
+   * const memoryLayer = await client.memoryLayers.create({ metadata: { name: 'sample' }, spec: { type: 'MEMORY_LAYER_TYPE_UNSPECIFIED' } });
+   * ```
+   */
+  create(params: MemoryLayerCreateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    return this._client.requestAPI<MemoryLayer>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers`, body: { metadata: params.metadata, spec: wireMemoryLayerSpec(params.spec) } };
+    }, options);
+  }
+
+  /**
+   * Get a memory layer by ID
+   * 
+   * @example
+   * ```ts
+   * const memoryLayer = await client.memoryLayers.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: MemoryLayerRetrieveParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    return this._client.requestAPI<MemoryLayer>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a memory layer
+   * 
+   * @example
+   * ```ts
+   * await client.memoryLayers.delete('_123');
+   * ```
+   */
+  delete(id: string, params?: MemoryLayerDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a memory layer
+   * 
+   * @example
+   * ```ts
+   * const memoryLayer = await client.memoryLayers.update('_123');
+   * ```
+   */
+  update(id: string, params?: MemoryLayerUpdateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    return this._client.requestAPI<MemoryLayer>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/memory_layers/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: wireMemoryLayerSpec(params?.spec), updateMask: params?.updateMask } };
+    }, options);
+  }
+}