@squidcloud/client 1.0.472 → 1.0.473

package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts

@@ -318,6 +318,13 @@ export interface AiChatPromptQuotas {
      * Default: 5.
      */
     maxAiCallStackSize: number;
+    /**
+     * Maximum wall-clock runtime, in seconds, of a single prompt for CLI-agent models
+     * (Claude Code, Codex). Optional override of the per-call self-kill deadline — mainly to
+     * tighten it for stricter runaway protection — clamped to [30, 1800]. Ignored for
+     * non-CLI-agent models. Default: the platform maximum (30 minutes).
+     */
+    maxRuntimeSeconds?: number;
 }
 /**
  * Options for AI agent execution plan, allowing the agent to plan what functionality to use (connected agents,
@@ -542,10 +549,44 @@ export interface OpenAiChatOptions extends BaseAiChatOptions {
     model?: OpenAiChatModelName;
 }
 /**
- * AI reasoning effort: Unsupported values are mapped to the closest supported option.
+ * Canonical reasoning-effort levels, ordered from least to most effort. These are the values that
+ * have a defined position on the effort axis and therefore participate in clamping when a model does
+ * not support the exact requested level.
  * @category AI
  */
-export type AiReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+export type CanonicalReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/**
+ * AI reasoning effort. Pass one of the canonical levels for portable, autocomplete-friendly usage, or
+ * a raw provider-native string when a model exposes a level outside the canonical set.
+ *
+ * Resolution against the selected model (see {@link ReasoningCapability}):
+ * - exact match with the model's capability -> used as-is (1:1);
+ * - canonical level the model lacks -> clamped to the nearest supported level (ties resolve downward);
+ * - unknown string the model cannot place on the axis -> dropped, so the model's own default applies,
+ *   with a warning;
+ * - model without a reasoning knob -> ignored, with a warning.
+ * @category AI
+ */
+export type AiReasoningEffort = CanonicalReasoningEffort | (string & {});
+/**
+ * Declares how a model exposes reasoning effort. Used as the single source of truth for resolving a
+ * requested {@link AiReasoningEffort} onto what the model natively accepts. When a request cannot be
+ * matched or clamped, no reasoning parameter is emitted and the model applies its own native default.
+ *
+ * - `none`: the model has no reasoning knob (e.g. it always reasons).
+ * - `levels`: the model accepts a fixed set of named levels (emitted as a string).
+ * - `budget`: the model accepts a token budget; each canonical level maps to a concrete integer.
+ * @category AI
+ */
+export type ReasoningCapability = {
+    kind: 'none';
+} | {
+    kind: 'levels';
+    supported: AiReasoningEffort[];
+} | {
+    kind: 'budget';
+    perLevel: Partial<Record<CanonicalReasoningEffort, number>>;
+};
 /**
  * Controls response length and detail level.
  * Use `low` for brief responses,`medium` for balanced detail, or `high` for comprehensive explanations.
@@ -900,6 +941,12 @@ export interface UserAiAskResponse {
     inputTokens?: number;
     /** The number of output tokens generated by the AI agent. */
     outputTokens?: number;
+    /** Cached input tokens read from the prompt cache. Only set by providers that report it (e.g. claude-code). */
+    cacheReadInputTokens?: number;
+    /** Input tokens written to the prompt cache. Only set by providers that report it (e.g. claude-code). */
+    cacheWriteInputTokens?: number;
+    /** Total request cost in USD as reported by the provider. Only set by providers that compute it (e.g. claude-code). */
+    totalCostUsd?: number;
 }
 /** Represents an annotation in the AI response. */
 export type AiAnnotation = AiFileAnnotation;

package/dist/internal-common/src/public-types/connector.public-types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * List of all connector package names.
+ * To prevent automatic discovery && latest version sync in 'prod' add your connector package name to
+ * 'CONNECTOR_PACKAGES_TO_EXCLUDE_FROM_AUTO_SYNC' in ConnectorsService (console-backend).
+ * @category Platform
+ */
+export declare const CONNECTOR_IDS: readonly ["confluence", "cotomi", "essentials", "freshdesk", "github", "google_calendar", "google_drive", "hubspot", "sharepoint", "jira", "jira_jsm", "linear", "mail", "onedrive", "salesforce", "servicenow_csm", "slack", "teams", "ticketmind_companion", "zendesk"];
+/**
+ * Unique connector package name.
+ * @category Platform
+ */
+export type ConnectorId = (typeof CONNECTOR_IDS)[number];

package/dist/typescript-client/src/admin-client.d.ts

@@ -1,8 +1,9 @@
+import { ConnectorClient } from './connector-client';
 import { IntegrationClient } from './integration-client';
 import { SecretClient } from './secret.client';
 /**
  * AdminClient provides access to application administrative operations,
- * including integrations and secrets management.
+ * including integrations, connectors, and secrets management.
  * @category Platform
  */
 export declare class AdminClient {
@@ -11,11 +12,16 @@ export declare class AdminClient {
     private readonly appId;
     private readonly consoleRegion;
     private readonly integrationClient;
+    private readonly connectorClient;
     private readonly secretClient;
     /**
      * Returns the IntegrationClient for managing integrations.
      */
     integrations(): IntegrationClient;
+    /**
+     * Returns the ConnectorClient for managing app-level (integration-less) connectors.
+     */
+    connectors(): ConnectorClient;
     /**
      * Returns the SecretClient for managing secrets.
      */

package/dist/typescript-client/src/connector-client.d.ts

@@ -0,0 +1,32 @@
+import { ConnectorId } from './public-types';
+/**
+ * ConnectorClient manages app-level (integration-less) connectors attached to an application.
+ *
+ * Unlike integrations, these connectors carry no per-connector configuration record — attaching one
+ * simply adds it to the application's `appConnectors` list and (re)deploys its bundle. Any configuration
+ * the connector needs is provided out of band (e.g. via application secrets).
+ * @category Platform
+ */
+export declare class ConnectorClient {
+    private readonly rpcManager;
+    private readonly iacBaseUrl;
+    /**
+     * Lists the connectors explicitly attached to the application.
+     *
+     * @returns A promise that resolves with the list of attached connector ids.
+     */
+    list(): Promise<Array<ConnectorId>>;
+    /**
+     * Attaches a connector to the application. Idempotent — attaching an already-attached connector is a
+     * no-op on the platform side.
+     *
+     * @param connectorId - The id of the connector to attach.
+     */
+    connect(connectorId: ConnectorId): Promise<void>;
+    /**
+     * Detaches a connector from the application.
+     *
+     * @param connectorId - The id of the connector to detach.
+     */
+    disconnect(connectorId: ConnectorId): Promise<void>;
+}

package/dist/typescript-client/src/index.d.ts

@@ -17,6 +17,7 @@ export * from './client-id.service';
 export * from './collection-reference';
 export * from './collection-reference.factory';
 export * from './connection-details';
+export * from './connector-client';
 export * from './console-utils';
 export * from './data.manager';
 export * from './destruct.manager';

package/dist/typescript-client/src/public-types.d.ts

@@ -11,6 +11,7 @@ export * from '../../internal-common/src/public-types/api.public-types';
 export * from '../../internal-common/src/public-types/backend.public-types';
 export * from '../../internal-common/src/public-types/code-executor.public-types';
 export * from '../../internal-common/src/public-types/communication.public-types';
+export * from '../../internal-common/src/public-types/connector.public-types';
 export * from '../../internal-common/src/public-types/context.public-types';
 export * from '../../internal-common/src/public-types/document.public-types';
 export * from '../../internal-common/src/public-types/event.public-types';

package/dist/typescript-client/src/version.d.ts

@@ -2,4 +2,4 @@
  * The current version of the SquidCloud client package.
  * @category Platform
  */
-export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.472";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.473";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.472",
+  "version": "1.0.473",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",