cadenya 0.16.0

package/src/resources/objectives/tool-calls.ts

@@ -0,0 +1,182 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import { APIPromise } from '../../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class ToolCalls extends APIResource {
+  /**
+   * Lists all tool calls for an objective
+   */
+  list(
+    objectiveID: string,
+    query: ToolCallListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ObjectiveToolCallsCursorPagination, ObjectiveToolCall> {
+    return this._client.getAPIList(
+      path`/v1/objectives/${objectiveID}/tool_calls`,
+      CursorPagination<ObjectiveToolCall>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * When an agent attempts to use a tool that requires approval, use this endpoint
+   * to mark it as approved. You may optionally include a memo in the approval as
+   * well.
+   */
+  approve(
+    toolCallID: string,
+    params: ToolCallApproveParams,
+    options?: RequestOptions,
+  ): APIPromise<ObjectiveToolCall> {
+    const { path_objectiveId, ...body } = params;
+    return this._client.put(path`/v1/objectives/${path_objectiveId}/tool_calls/${toolCallID}/approve`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * When an agent attempts to use a tool that requires approval, use this endpoint
+   * to mark it as denied. You may optionally include a memo in the denial as well.
+   * If provided, the memo is passed to the agent when a rejection occurs so you may
+   * provide further instructions.
+   */
+  deny(
+    toolCallID: string,
+    params: ToolCallDenyParams,
+    options?: RequestOptions,
+  ): APIPromise<ObjectiveToolCall> {
+    const { path_objectiveId, ...body } = params;
+    return this._client.put(path`/v1/objectives/${path_objectiveId}/tool_calls/${toolCallID}/deny`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export type ObjectiveToolCallsCursorPagination = CursorPagination<ObjectiveToolCall>;
+
+/**
+ * ObjectiveToolCall is a record of a tool call made during an objective's
+ * execution. Tool calls are mutable — their status changes as they are approved,
+ * denied, or executed.
+ */
+export interface ObjectiveToolCall {
+  /**
+   * Profile represents a human user at the account level. Profiles are
+   * account-scoped resources that can be associated with multiple workspaces through
+   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   */
+  approvedBy?: Shared.Profile;
+
+  /**
+   * The arguments passed to the tool
+   */
+  arguments?: { [key: string]: unknown };
+
+  /**
+   * CallableTool is a union that represents a tool that can be called by an agent.
+   * In Cadenya, a tool that is used within an agent objective might be a
+   * user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
+   * and a Cadenya Tool (one Cadenya provides). These tools
+   */
+  callable?: Shared.CallableTool;
+
+  /**
+   * Profile represents a human user at the account level. Profiles are
+   * account-scoped resources that can be associated with multiple workspaces through
+   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   */
+  deniedBy?: Shared.Profile;
+
+  /**
+   * A memo supplied by the approver or denier
+   */
+  memo?: string;
+
+  /**
+   * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+   * runs)
+   */
+  metadata?: Shared.OperationMetadata;
+
+  /**
+   * The objective this tool call belongs to
+   */
+  objectiveId?: string;
+
+  /**
+   * The result content returned by the tool after execution
+   */
+  result?: string;
+
+  /**
+   * Current status of the tool call
+   */
+  status?:
+    | 'TOOL_CALL_STATUS_PENDING'
+    | 'TOOL_CALL_STATUS_APPROVED'
+    | 'TOOL_CALL_STATUS_DENIED'
+    | 'TOOL_CALL_STATUS_EXECUTED';
+}
+
+export interface ToolCallListParams extends CursorPaginationParams {}
+
+export interface ToolCallApproveParams {
+  /**
+   * Path param: The ID of the objective. Supports "eid:" prefix for external IDs.
+   */
+  path_objectiveId: string;
+
+  /**
+   * Body param: A memo to associate to the tool call approval
+   */
+  memo?: string;
+
+  /**
+   * Body param: The ID of the objective. Supports "eid:" prefix for external IDs.
+   */
+  body_objectiveId?: string;
+
+  /**
+   * Body param: The ID of the tool call to approve
+   */
+  body_toolCallId?: string;
+}
+
+export interface ToolCallDenyParams {
+  /**
+   * Path param: The ID of the objective. Supports "eid:" prefix for external IDs.
+   */
+  path_objectiveId: string;
+
+  /**
+   * Body param: A memo to associate to the tool call denial
+   */
+  memo?: string;
+
+  /**
+   * Body param: The ID of the objective. Supports "eid:" prefix for external IDs.
+   */
+  body_objectiveId?: string;
+
+  /**
+   * Body param: The ID of the tool call to deny
+   */
+  body_toolCallId?: string;
+}
+
+export declare namespace ToolCalls {
+  export {
+    type ObjectiveToolCall as ObjectiveToolCall,
+    type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination,
+    type ToolCallListParams as ToolCallListParams,
+    type ToolCallApproveParams as ToolCallApproveParams,
+    type ToolCallDenyParams as ToolCallDenyParams,
+  };
+}

package/src/resources/objectives.ts

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

package/src/resources/search.ts

@@ -0,0 +1,39 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as AgentsAPI from './agents/agents';
+import * as ToolSetsAPI from './tool-sets/tool-sets';
+import * as ToolsAPI from './tool-sets/tools';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Search extends APIResource {
+  /**
+   * Searches for tools or tool sets in the workspace
+   */
+  searchToolsOrToolSets(
+    query: SearchSearchToolsOrToolSetsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SearchSearchToolsOrToolSetsResponse> {
+    return this._client.get('/v1/search/tools_or_tool_sets', { query, ...options });
+  }
+}
+
+export interface SearchSearchToolsOrToolSetsResponse {
+  agents?: Array<AgentsAPI.Agent>;
+
+  tools?: Array<ToolsAPI.Tool>;
+
+  toolSets?: Array<ToolSetsAPI.ToolSet>;
+}
+
+export interface SearchSearchToolsOrToolSetsParams {
+  query?: string;
+}
+
+export declare namespace Search {
+  export {
+    type SearchSearchToolsOrToolSetsResponse as SearchSearchToolsOrToolSetsResponse,
+    type SearchSearchToolsOrToolSetsParams as SearchSearchToolsOrToolSetsParams,
+  };
+}

package/src/resources/shared.ts

@@ -0,0 +1,203 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as WorkspacesAPI from './workspaces';
+import { CursorPagination } from '../core/pagination';
+
+/**
+ * AccountResourceMetadata is used to represent a resource that is associated to an
+ * account but not to a workspace.
+ */
+export interface AccountResourceMetadata {
+  /**
+   * Unique identifier for the resource (UUID v7)
+   */
+  id?: string;
+
+  /**
+   * Account this resource belongs to for multi-tenant isolation (UUID v7)
+   */
+  accountId?: string;
+
+  /**
+   * External ID for the resource (e.g., a workflow ID from an external system)
+   */
+  externalId?: string;
+
+  /**
+   * Arbitrary key-value pairs for categorization and filtering Examples:
+   * {"environment": "production", "team": "platform", "version": "v2"}
+   */
+  labels?: { [key: string]: string };
+
+  /**
+   * Human-readable name for the resource (e.g., "Customer Support Agent", "Email
+   * Tool") Required for resources that users interact with directly
+   */
+  name?: string;
+
+  profileId?: string;
+}
+
+/**
+ * CallableTool is a union that represents a tool that can be called by an agent.
+ * In Cadenya, a tool that is used within an agent objective might be a
+ * user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
+ * and a Cadenya Tool (one Cadenya provides). These tools
+ */
+export interface CallableTool {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  agent?: ResourceMetadata;
+
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  cadenyaProvidedTool?: ResourceMetadata;
+
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  tool?: ResourceMetadata;
+}
+
+/**
+ * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+ * runs)
+ */
+export interface OperationMetadata {
+  /**
+   * Unique identifier for the operation (UUID v7)
+   */
+  id?: string;
+
+  /**
+   * Account this operation belongs to for multi-tenant isolation (UUID v7)
+   */
+  accountId?: string;
+
+  /**
+   * Timestamp when this operation was created UUID v7 includes timestamp
+   * information, but this explicit field enables easier querying
+   */
+  createdAt?: string;
+
+  /**
+   * External ID for the operation (e.g., a workflow ID from an external system)
+   */
+  externalId?: string;
+
+  /**
+   * Arbitrary key-value pairs for categorization and filtering Examples:
+   * {"priority": "high", "source": "api", "workflow": "onboarding"}
+   */
+  labels?: { [key: string]: string };
+
+  /**
+   * ID of the actor (user or service account) that created this operation
+   */
+  profileId?: string;
+
+  /**
+   * Workspace this operation belongs to for organizational grouping (UUID v7)
+   */
+  workspaceId?: string;
+}
+
+/**
+ * Profile represents a human user at the account level. Profiles are
+ * account-scoped resources that can be associated with multiple workspaces through
+ * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+ */
+export interface Profile {
+  /**
+   * AccountResourceMetadata is used to represent a resource that is associated to an
+   * account but not to a workspace.
+   */
+  metadata?: AccountResourceMetadata;
+
+  /**
+   * ProfileSpec contains the profile-specific fields
+   */
+  spec?: ProfileSpec;
+}
+
+/**
+ * ProfileSpec contains the profile-specific fields
+ */
+export interface ProfileSpec {
+  /**
+   * Email address of the user (required, unique per account)
+   */
+  email?: string;
+
+  /**
+   * Display name for the user (e.g., "Bobby Tables")
+   */
+  name?: string;
+
+  /**
+   * Type is the type of profile. User's are humans, API keys are computers. You know
+   * the deal.
+   */
+  type?: 'PROFILE_TYPE_USER' | 'PROFILE_TYPE_API_KEY' | 'PROFILE_TYPE_SYSTEM';
+}
+
+/**
+ * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+ */
+export interface ResourceMetadata {
+  /**
+   * Unique identifier for the resource (UUID v7)
+   */
+  id?: string;
+
+  /**
+   * Account this resource belongs to for multi-tenant isolation (UUID v7)
+   */
+  accountId?: string;
+
+  /**
+   * Timestamp when this resource was created
+   */
+  createdAt?: string;
+
+  /**
+   * External ID for the resource (e.g., a workflow ID from an external system)
+   */
+  externalId?: string;
+
+  /**
+   * Arbitrary key-value pairs for categorization and filtering Examples:
+   * {"environment": "production", "team": "platform", "version": "v2"}
+   */
+  labels?: { [key: string]: string };
+
+  /**
+   * Human-readable name for the resource (e.g., "Customer Support Agent", "Email
+   * Tool") Required for resources that users interact with directly
+   */
+  name?: string;
+
+  /**
+   * ID of the actor (user or service account) that created this resource
+   */
+  profileId?: string;
+
+  /**
+   * Workspace this resource belongs to for organizational grouping (UUID v7)
+   */
+  workspaceId?: string;
+}
+
+export interface Workspace {
+  /**
+   * AccountResourceMetadata is used to represent a resource that is associated to an
+   * account but not to a workspace.
+   */
+  metadata?: AccountResourceMetadata;
+
+  spec?: WorkspacesAPI.WorkspaceSpec;
+}
+
+export type WorkspacesCursorPagination = CursorPagination<Workspace>;

package/src/resources/tool-sets/index.ts

@@ -0,0 +1,37 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  ToolSets,
+  type McpToolFilter,
+  type SyncCompleted,
+  type SyncFailed,
+  type SyncStarted,
+  type ToolSet,
+  type ToolSetAdapter,
+  type ToolSetAdapterHTTP,
+  type ToolSetAdapterMcp,
+  type ToolSetEvent,
+  type ToolSetEventData,
+  type ToolSetSpec,
+  type ToolSetCreateParams,
+  type ToolSetUpdateParams,
+  type ToolSetListParams,
+  type ToolSetListEventsParams,
+  type ToolSetsCursorPagination,
+  type ToolSetEventsCursorPagination,
+} from './tool-sets';
+export {
+  Tools,
+  type ConfigHTTP,
+  type ConfigMcp,
+  type Tool,
+  type ToolSpec,
+  type ToolSpecConfig,
+  type ToolSpecContentFilter,
+  type ToolCreateParams,
+  type ToolRetrieveParams,
+  type ToolUpdateParams,
+  type ToolListParams,
+  type ToolDeleteParams,
+  type ToolsCursorPagination,
+} from './tools';