@squidcloud/client 1.0.499 → 1.0.501

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

@@ -488,11 +488,28 @@ export interface BackupModelOptions {
     /** Response length and detail level; supported by OpenAI models only. */
     verbosity?: AiVerbosityLevel;
 }
-/**
- * The base AI agent chat options, should not be used directly.
- * @category AI
- */
+/** Configures independent answer validation and bounded correction. @category AI */
+export interface AiAnswerValidationOptions {
+    /** Judge model; defaults to the model that produced the initial answer. */
+    model?: AiChatModelSelection;
+    /** Additional acceptance criteria for the judge. */
+    instructions?: string;
+    /** Maximum answer attempts, including the initial answer. Defaults to 2; accepts 1–5. */
+    maxAttempts?: number;
+}
+/** Reports the judge's verdict for the returned answer. @category AI */
+export interface AiAnswerValidationResult {
+    /** Whether the returned answer passed validation; false also covers incomplete validation. */
+    passed: boolean;
+    /** Concise explanation of the verdict or validation failure. */
+    summary: string;
+    /** Actionable defects or reasons validation could not complete. */
+    issues: Array<string>;
+}
+/** Shared options for agent chat requests. @category AI */
 export interface BaseAiChatOptions {
+    /** Enables validation for non-CLI models; an empty object uses defaults. Judge read-only behavior is instruction-based. */
+    validation?: AiAnswerValidationOptions;
     /**
      * The maximum number of input tokens that Squid can use when making the request to the AI model.
      * Defaults to the max tokens the model can accept.
@@ -1445,6 +1462,8 @@ export interface DeleteAgentRequest {
  * @category AI
  */
 export interface AiAskResponse {
+    /** Judge verdict, present when answer validation is enabled. */
+    validation?: AiAnswerValidationResult;
     /** The response string from the agent */
     responseString: string;
     /** Optional annotations (e.g., file references) in the response */

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

@@ -1189,6 +1189,11 @@ export interface GeneratedMetadataFieldDescription {
 export interface GetKnowledgeBaseGraphStatusRequest {
     /** The id of the AiKnowledgeBase. */
     knowledgeBaseId: AiKnowledgeBaseId;
+    /**
+     * Whether to include the topic table (`topics`, `topicEdges`). Default true. A poller that reads only the
+     * build state can pass false: on a large graph the table runs to thousands of topics.
+     */
+    includeTopics?: boolean;
 }
 /**
  * Response structure for a knowledge base's GraphRAG build/readiness status. Drives the ai-eval
@@ -1552,17 +1557,20 @@ export interface RebuildKnowledgeBaseGraphRequest {
      */
     ignoreActiveBulkJobs?: boolean;
 }
+/** Hard ceiling on the nodes one graph explore returns: a larger `nodeLimit` is clamped down to this value. */
+export declare const KNOWLEDGE_BASE_GRAPH_EXPLORE_MAX_NODES = 1000;
+/** Longest `search` text a graph explore accepts; a longer one is rejected. */
+export declare const KNOWLEDGE_BASE_GRAPH_SEARCH_MAX_LENGTH = 200;
 /**
- * Request structure for exploring a bounded subgraph of a knowledge base's graph (Phase 3 visualization).
- * Returns the highest-degree entities and the relationships among them. Seed-based exploration
- * (prompt/entity-name seeding + traversal depth) is a planned extension; its fields will be added
- * here once implemented.
+ * Request structure for exploring a bounded subgraph of a knowledge base's graph (visualization). By default
+ * it returns the highest-degree entities and the relationships among them; `topicId`, `entityId` and `search`
+ * select other entity pools, and `contextMetadataFilter` narrows any of them.
  * @category AI
  */
 export interface ExploreKnowledgeBaseGraphRequest {
     /** The id of the AiKnowledgeBase. */
     knowledgeBaseId: AiKnowledgeBaseId;
-    /** Hard cap on returned nodes. Default 200, max 1000. */
+    /** Hard cap on returned nodes. Default 200, at most {@link KNOWLEDGE_BASE_GRAPH_EXPLORE_MAX_NODES}. */
     nodeLimit?: number;
     /**
      * Restricts the subgraph to entities under the given topic node id — any hierarchy level; an entity
@@ -1570,6 +1578,30 @@ export interface ExploreKnowledgeBaseGraphRequest {
      * `TOPIC_NOT_FOUND`. Ids come from {@link KnowledgeBaseGraphTopic.id} and churn on rebuild.
      */
     topicId?: string;
+    /**
+     * Centers the subgraph on one entity: the entity plus its neighbors, strongest relationships first. Ids
+     * come from {@link KnowledgeBaseGraphNode.id} and churn on rebuild; an unknown id fails with
+     * `ENTITY_NOT_FOUND`. Cannot be combined with `topicId` or `search`.
+     */
+    entityId?: string;
+    /**
+     * Finds entities by name: exact names and aliases first, then prefixes, then substrings, each by degree.
+     * When no name matches, returns the entities nearest in meaning instead (`searchMatch: 'similar'`).
+     * At most {@link KNOWLEDGE_BASE_GRAPH_SEARCH_MAX_LENGTH} characters. Cannot be combined with `topicId` or
+     * `entityId`.
+     */
+    search?: string;
+    /**
+     * Keeps only the entities mentioned by contexts matching the filter. Without `entityId` or `search`, they
+     * are ranked by how many matching contexts mention them. Filters on context-record metadata only, not on
+     * per-chunk keys.
+     */
+    contextMetadataFilter?: AiContextMetadataFilter;
+    /**
+     * Whether to attach the topic table (`topics`). Default true. A caller that already holds it can pass false:
+     * on a large graph the table runs to thousands of topics.
+     */
+    includeTopics?: boolean;
 }
 /** A node in an {@link ExploreKnowledgeBaseGraphResponse}. @category AI */
 export interface KnowledgeBaseGraphNode {
@@ -1608,14 +1640,32 @@ export interface KnowledgeBaseGraphEdge {
 export interface ExploreKnowledgeBaseGraphResponse {
     /** The subgraph nodes. */
     nodes: Array<KnowledgeBaseGraphNode>;
-    /** The subgraph edges (outgoing only, both endpoints present in `nodes`). */
+    /**
+     * The subgraph edges (outgoing only, both endpoints present in `nodes`). Capped: past the cap only the
+     * heaviest are returned and {@link edgesTruncated} is set.
+     */
     edges: Array<KnowledgeBaseGraphEdge>;
+    /** True when the nodes are linked by more relationships than `edges` carries. */
+    edgesTruncated?: boolean;
     /**
      * The KB's topic (theme) nodes — the id→name/hierarchy table for the nodes' `topicPath` ids, so a
      * visualization can label and group by theme without extra round trips. Present when the concept
-     * layer has been built (a rebuild ran).
+     * layer has been built (a rebuild ran). Under `contextMetadataFilter`, `docCount` counts only the
+     * matching contexts.
      */
     topics?: Array<KnowledgeBaseGraphTopic>;
+    /**
+     * Size of the pool the subgraph was cut from — the entities in scope, the topic's members, the entity's
+     * neighbors or the search matches. Compare with `nodes.length` to offer more. Absent when not counted.
+     */
+    totalCount?: number;
+    /** How a `search` matched: by entity name, or by meaning when no name matched. */
+    searchMatch?: 'name' | 'similar';
+    /**
+     * True when `contextMetadataFilter` matched more contexts than one request reads; the subgraph then
+     * covers only the first of them.
+     */
+    scopeTruncated?: boolean;
 }
 /**
  * A topic (theme) node of the graph's concept layer, as referenced by
@@ -1656,12 +1706,14 @@ export interface KnowledgeBaseGraphTopicEdge {
  * round trip with a complete answer — no per-level walking.
  * @category AI
  */
-export type KnowledgeBaseGraphQueryOp = 'overview' | 'resolve' | 'describe' | 'subtree' | 'docsUnder' | 'conceptsOf' | 'neighborhood' | 'pathBetween' | 'globalSummary';
+export type KnowledgeBaseGraphQueryOp = 'overview' | 'resolve' | 'describe' | 'subtree' | 'docsUnder' | 'conceptsOf' | 'neighborhood' | 'pathBetween' | 'globalSummary' | 'relationship';
 /**
  * Request structure for querying a knowledge base's graph (documents, entities, topics, facets) through
  * the closed op set. `ref` accepts a facet nodeId (`facet_…` — exact; the only persistable concept
- * handles) or a name, resolved server-side (exact → alias → similarity). An unresolvable ref fails with
- * `CONCEPT_NOT_FOUND` plus the nearest matching names.
+ * handles), a topic id from {@link KnowledgeBaseGraphTopic.id} or an entity id from
+ * {@link KnowledgeBaseGraphNode.id} (both exact, both churn on rebuild) or a name, resolved server-side
+ * (exact → alias → similarity). An unresolvable ref fails with `CONCEPT_NOT_FOUND` plus the nearest
+ * matching names.
  * @category AI
  */
 export interface QueryKnowledgeBaseGraphRequest {
@@ -1669,9 +1721,12 @@ export interface QueryKnowledgeBaseGraphRequest {
     knowledgeBaseId: AiKnowledgeBaseId;
     /** The operation to run. */
     op: KnowledgeBaseGraphQueryOp;
-    /** Node ref (name or facet nodeId). Required by resolve/describe/subtree/docsUnder/neighborhood/pathBetween. */
+    /**
+     * Node ref (name, facet nodeId, topic id or entity id). Required by resolve/describe/subtree/docsUnder/
+     * neighborhood/pathBetween/relationship.
+     */
     ref?: string;
-    /** Second node ref for `pathBetween`. */
+    /** Second node ref for `pathBetween`, and the target entity for `relationship`. */
     refB?: string;
     /** The document's contextId for `conceptsOf`. */
     contextId?: string;
@@ -1683,8 +1738,16 @@ export interface QueryKnowledgeBaseGraphRequest {
     hops?: number;
     /** `docsUnder`: when true (default), include documents under the whole subtree, not just the node itself. */
     recursive?: boolean;
-    /** `docsUnder`: maximum documents returned. Default 25, max 100 (`totalDocs` always reports the full count). */
+    /**
+     * `docsUnder` and `relationship`: maximum documents returned. Default 25, max 100 (`totalDocs` always
+     * reports the full count).
+     */
     limit?: number;
+    /**
+     * `docsUnder` and `relationship`: keeps only the documents whose context matches the filter. Filters on
+     * context-record metadata only, not on per-chunk keys.
+     */
+    contextMetadataFilter?: AiContextMetadataFilter;
 }
 /** One node matched by a graph query (`resolve`, and the anchors of other ops). @category AI */
 export interface KnowledgeBaseGraphQueryMatch {
@@ -1767,6 +1830,27 @@ export interface KnowledgeBaseGraphQueryPath {
     /** Thematic tier: names of concepts both refs sit under. */
     sharedConcepts?: Array<string>;
 }
+/**
+ * A `relationship` answer: the direct relationship between two entities, in its asserted direction, and
+ * the documents asserting it.
+ * @category AI
+ */
+export interface KnowledgeBaseGraphQueryRelationship {
+    /** Source entity name. */
+    source: string;
+    /** Target entity name. */
+    target: string;
+    /** Relationship label. */
+    type: string;
+    /** Relationship description, when the extraction produced one. */
+    description?: string;
+    /** How many times the relationship was asserted. */
+    weight: number;
+    /** Documents asserting the relationship (capped by `limit`). */
+    documents: Array<KnowledgeBaseGraphQueryDoc>;
+    /** Number of documents asserting it (compare with `documents.length` for truncation). */
+    totalDocs: number;
+}
 /**
  * Response structure for a graph query. `op` echoes the request; exactly the fields that op produces
  * are set (e.g. `matches` for `resolve`, `tree` for `subtree`).
@@ -1803,6 +1887,13 @@ export interface QueryKnowledgeBaseGraphResponse {
     pathBetween?: KnowledgeBaseGraphQueryPath;
     /** `globalSummary`: the KB's topic summaries ranked against the query, most relevant first. */
     summaries?: Array<KnowledgeBaseGraphQueryGlobalSummary>;
+    /** `relationship`: the relationship between `ref` and `refB` and the documents asserting it. */
+    relationship?: KnowledgeBaseGraphQueryRelationship;
+    /**
+     * True when `contextMetadataFilter` matched more contexts than one request reads; the documents then come
+     * from only the first of them.
+     */
+    scopeTruncated?: boolean;
 }
 /**
  * One context to stage through bulk ingestion. Unlike the sync request, `imageExtractionModel` is not

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

@@ -10,3 +10,48 @@ export declare const CONNECTOR_IDS: readonly ["bitbucket", "confluence", "connec
  * @category Platform
  */
 export type ConnectorId = (typeof CONNECTOR_IDS)[number];
+/** Where one file/folder sits in a connector's own tracking, independent of the KB ledger. */
+export type ConnectorPathStatusClassification = 'indexed' | 'staged' | 'failed' | 'skipped' | 'folder_tracked';
+/** The durable ingestion status of one file in the knowledge base ledger, as {@link ConnectorPathStatusEntry.kbStatus}. */
+export interface ConnectorKbFileStatus {
+    /** The file's current durable status in the knowledge base ledger. */
+    status: 'no_record' | 'in_progress' | 'completed' | 'failed';
+    /** Present only when `status` is `'failed'`. */
+    errorMessage?: string;
+    /** Present only when `status` is `'failed'`, when known. */
+    errorCode?: string;
+    /** When this status was last recorded; absent when `status` is `'no_record'`. */
+    updatedAt?: Date;
+}
+/** One file or folder a connector knows about at or under a searched path. */
+export interface ConnectorPathStatusEntry {
+    /** The connector-specific id of the document. */
+    documentId: string;
+    /** The document's name. */
+    name: string;
+    /** Whether this document is a file or a folder. */
+    type: 'file' | 'folder';
+    /** Folder path, when this document was indexed through a folder. With `name`, forms the KB ledger's lookup path. */
+    folderPath?: string;
+    /** Where this document sits in the connector's own tracking. */
+    classification: ConnectorPathStatusClassification;
+    /** Message describing the most recent failure, when `classification` is `'failed'` or `'skipped'`. */
+    errorMessage?: string;
+    /** Last successful ingestion, when the document has one. */
+    lastIndexedDate?: Date;
+    /** The knowledge-base context ID this document maps to, when it has one. */
+    contextId?: string;
+    /** The KB ledger's own status for this file, when the connector resolved one. */
+    kbStatus?: ConnectorKbFileStatus;
+}
+/** A connector's own record of files/folders matching a searched path, from `Squid.getConnectorPathStatus`. */
+export interface ConnectorPathStatusResult {
+    /** False when the integration's type doesn't expose path-status search (most types). */
+    supported: boolean;
+    /** The knowledge base this integration indexes into, when resolvable. */
+    knowledgeBaseId?: string;
+    /** The matching files/folders, absent when `supported` is false. */
+    entries?: Array<ConnectorPathStatusEntry>;
+    /** True when more matches exist than `entries` returns. */
+    truncated?: boolean;
+}

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

@@ -11,6 +11,7 @@ export declare class AdminClient {
     private readonly region;
     private readonly appId;
     private readonly consoleRegion;
+    private readonly backendFunctionManager;
     private readonly integrationClient;
     private readonly connectorClient;
     private readonly secretClient;

package/dist/typescript-client/src/agent/ai-agent-client-reference.d.ts

@@ -132,6 +132,8 @@ export declare class AiAgentReference {
      *   knows it can look up the job’s status.
      */
     ask<T extends AiAskModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<string>;
+    /** Returns the answer, annotations, routing information, and optional validation verdict. */
+    askWithResult<T extends AiAskModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<AskResponse>;
     /**
      * Sends a prompt and returns the string response and file annotations.
      * @param prompt The text prompt to send to the agent.

package/dist/typescript-client/src/agent/ai-agent-client.types.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiAnnotation, AiAskModelSelection, AiChatModelSelection, AiChatOptions, AiChatRequestCredentials, AiModelRoutingResult } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAnnotation, AiAnswerValidationResult, AiAskModelSelection, AiChatModelSelection, AiChatOptions, AiChatRequestCredentials, AiModelRoutingResult } from '../../../internal-common/src/public-types/ai-agent.public-types';
 /**
  * Response format for transcribing audio and generating a chat response.
  * Contains the transcribed text and a stream of AI-generated responses.
@@ -29,6 +29,8 @@ export interface TranscribeAndAskWithVoiceResponse {
  * @category AI
  */
 export interface AskResponse {
+    /** Judge verdict, present when answer validation is enabled. */
+    validation?: AiAnswerValidationResult;
     /** The main text response from the AI agent. */
     responseString: string;
     /** Optional annotations that provide additional context or metadata about the response. */

package/dist/typescript-client/src/ai-knowledge-base/ai-knowledge-base-client-reference.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseFileStatusInfo, AiKnowledgeBaseFolderStatusResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, BulkIngestionContext, BulkIngestionCreateUploadUrlsResponse, BulkIngestionJobStatusResponse, BulkIngestionUpsertContextsOptions, BulkIngestionUpsertContextsResponse, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseFileStatusInfo, AiKnowledgeBaseFolderStatusResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, BulkIngestionContext, BulkIngestionCreateUploadUrlsResponse, BulkIngestionJobStatusResponse, BulkIngestionUpsertContextsOptions, BulkIngestionUpsertContextsResponse, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusRequest, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
 import { AiContextId } from '../../../internal-common/src/public-types/communication.public-types';
 /**
  * Parameters for creating or updating an AI agent.
@@ -197,16 +197,17 @@ export declare class AiKnowledgeBaseReference {
     /**
      * Queries the knowledge base's graph (documents, entities, themes, facets) through the closed op set
      * — overview / resolve / describe / subtree / docsUnder / conceptsOf / neighborhood / pathBetween /
-     * globalSummary. Requires `graphRag.enabled` on the knowledge base. Refused on a knowledge base with
-     * `accessControl.mode: 'enforced'` — the graph carries no access scopes, so its answers cannot be
-     * filtered per caller.
+     * globalSummary / relationship. Requires `graphRag.enabled` on the knowledge base. Refused on a knowledge
+     * base with `accessControl.mode: 'enforced'` — the graph carries no access scopes, so its answers cannot
+     * be filtered per caller.
      */
     queryGraph(request: Omit<QueryKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<QueryKnowledgeBaseGraphResponse>;
     /**
      * Returns the knowledge base's graph build/readiness status: counts, facets, staleness, the most
      * recent rebuild job, and the graph's LLM token/cost usage (`ingestUsage`, `lastRebuildUsage`).
+     * Pass `includeTopics: false` to poll it without the topic table.
      */
-    getGraphStatus(): Promise<GetKnowledgeBaseGraphStatusResponse>;
+    getGraphStatus(options?: Omit<GetKnowledgeBaseGraphStatusRequest, 'knowledgeBaseId'>): Promise<GetKnowledgeBaseGraphStatusResponse>;
     /**
      * Looks up the durable ingestion status of one file by path (`folderPath/filename`, or just
      * `filename` at the upload root): `'completed'`, `'failed'` (with `errorMessage`/`errorCode`),
@@ -231,8 +232,9 @@ export declare class AiKnowledgeBaseReference {
      */
     rebuildGraph(request?: Omit<RebuildKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<void>;
     /**
-     * Returns a bounded slice of the knowledge base's entity graph (highest-degree entities and the
-     * relationships among them) for exploration/visualization. Requires `graphRag.enabled`.
+     * Returns a bounded slice of the knowledge base's entity graph for exploration/visualization: the
+     * highest-degree entities, a topic's members, an entity's neighborhood or a name search, optionally
+     * narrowed by a context metadata filter, with the relationships among them. Requires `graphRag.enabled`.
      */
     exploreGraph(request?: Omit<ExploreKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<ExploreKnowledgeBaseGraphResponse>;
     /**

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

@@ -1,4 +1,4 @@
-import { DiscoverSourceRepositoriesResponse, IntegrationId, IntegrationInfo, IntegrationType } from './public-types';
+import { ConnectorPathStatusResult, DiscoverSourceRepositoriesResponse, IntegrationId, IntegrationInfo, IntegrationType } from './public-types';
 /**
  * IntegrationClient manages integrations within an application,
  * providing methods for listing, retrieving, updating, and deleting integrations.
@@ -6,6 +6,7 @@ import { DiscoverSourceRepositoriesResponse, IntegrationId, IntegrationInfo, Int
  */
 export declare class IntegrationClient {
     private readonly rpcManager;
+    private readonly backendFunctionManager;
     private readonly iacBaseUrl;
     /**
      * Lists all enabled integrations for the current application.
@@ -23,6 +24,18 @@ export declare class IntegrationClient {
      * @returns A promise that resolves with the integration info, or `undefined` if not found.
      */
     get<ConfigurationType = Record<string, any>>(integrationId: IntegrationId): Promise<IntegrationInfo<ConfigurationType> | undefined>;
+    /**
+     * Searches a connector's own record of files/folders at a path — for connectors (SharePoint, and
+     * any future file/folder-hierarchy connector) that track more than the AI knowledge base ledger
+     * does. Returns `{ supported: false }` when the integration's type doesn't support this. The
+     * connector's own executable requires an API key, so this call fails unless the `Squid` instance
+     * is authenticated with one.
+     *
+     * @param integrationId - The ID of the integration to search.
+     * @param path - The path, folder, or filename to search for.
+     * @returns A promise that resolves to the connector's path-status result.
+     */
+    getPathStatus(integrationId: IntegrationId, path: string): Promise<ConnectorPathStatusResult>;
     /**
      * Enables a disabled integration. The integration becomes available again for runtime access and sync jobs.
      *

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.499";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.501";

package/package.json

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

package/dist/internal-common/src/ai/system-openai-compatible.d.ts

@@ -1,35 +0,0 @@
-/**
- * System-level OpenAI-compatible backends ("slots") for Squid's own internal AI calls.
- *
- * Generic plumbing for pointing an internal model at ANY OpenAI-compatible HTTP endpoint —
- * primarily Squid's own self-hosted models, but any OpenAI-compatible backend works. The
- * non-secret part of a slot (base URL, optional headers/extra body) is hardcoded here on purpose
- * (changing a backend is a reviewed code change); only the API key lives in Vault under
- * `SystemSecrets['openai-compatible'][slotName].apiKey`.
- *
- * NOT the customer-facing `openai_compatible` Integration (per-app, console-configured). Models
- * served through these slots are declared in `AI_CHAT_MODEL_REGISTRY` with
- * `providerType: 'openai-compatible'` + `openAiCompatibleSlot`, and resolve only with
- * `keyType: 'system'` (see `AiProviderFactory.getChatProviderForModel`) — never customer-reachable.
- *
- * No slots are defined yet (foundation only). To wire one up:
- *   1. add a slot below, e.g. `'my-model': { baseUrl: 'https://llm.internal.squid/v1' }`;
- *   2. seed its key in `SystemSecrets['openai-compatible']['my-model'].apiKey`;
- *   3. add a model entry in ai-model.registry.ts pointing `openAiCompatibleSlot: 'my-model'`.
- */
-/** Non-secret configuration of one system OpenAI-compatible backend. */
-export interface SystemOpenAiCompatibleSlotConfig {
-    /** Base URL of the OpenAI-compatible API, e.g. a self-hosted 'https://llm.internal.squid/v1'. */
-    baseUrl: string;
-    /** Extra HTTP headers sent with every request. */
-    headers?: Record<string, string>;
-    /** Extra JSON body fields merged into every request — reserved wire fields are dropped by the provider. */
-    extraBody?: Record<string, unknown>;
-}
-/** Name of a system OpenAI-compatible slot (a key of `SYSTEM_OPENAI_COMPATIBLE_SLOTS`). */
-export type SystemOpenAiCompatibleSlotName = string;
-/**
- * Registered system OpenAI-compatible slots, keyed by name. Empty by design — add a self-hosted
- * (or any other) OpenAI-compatible backend here; see the module doc above.
- */
-export declare const SYSTEM_OPENAI_COMPATIBLE_SLOTS: Record<SystemOpenAiCompatibleSlotName, SystemOpenAiCompatibleSlotConfig>;

package/dist/internal-common/src/metric-name.d.ts

@@ -1,5 +0,0 @@
-/** Names of the Squid metrics; dashboards and metric queries key on these exact strings. */
-export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatReasoningTokens_count", "squid_aiChatbotChatCacheReadInputTokens_count", "squid_aiChatbotChatCacheWriteInputTokens_count", "squid_aiChatbotChatCostUsd_count", "squid_aiChatbotChatOutcome_count", "squid_aiSpendInputTokens_count", "squid_aiSpendOutputTokens_count", "squid_aiSpendReasoningTokens_count", "squid_aiSpendCacheReadTokens_count", "squid_aiSpendCacheWriteTokens_count", "squid_aiSpendPages_count", "squid_aiSpendImages_count", "squid_aiSpendAudioSeconds_count", "squid_aiSpendCharacters_count", "squid_aiSpendSearches_count", "squid_aiSpendCostUsd_count", "squid_aiImageGeneration_count", "squid_aiImageGeneration_time", "squid_aiRemoveBackground_count", "squid_aiRemoveBackground_time", "squid_aiAudioTranscribe_count", "squid_aiAudioTranscribe_time", "squid_aiAudioCreateSpeech_count", "squid_aiAudioCreateSpeech_time", "squid_aiVoiceCreateSession_count", "squid_aiVoiceCreateSession_time", "squid_aiVoiceAnswerOpenAiCall_count", "squid_aiVoiceAnswerOpenAiCall_time", "squid_aiVoiceStartOpenAiWebCall_count", "squid_aiVoiceStartOpenAiWebCall_time", "squid_aiOpenAiChatCompletions_count", "squid_aiOpenAiChatCompletions_time", "squid_aiIntegrationData_count", "squid_aiIntegrationData_time", "squid_aiIntegrationApi_count", "squid_aiIntegrationApi_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_aiContextUpsert_count", "squid_aiContextDelete_count", "squid_codeInitialization_count", "squid_codeInitialization_time", "squid_sourceCodeAnalysis_count", "squid_sourceCodeAnalysis_time", "squid_sourceCodeWorkspaceBytes_value", "squid_sourceCodeInputTokens_count", "squid_sourceCodeOutputTokens_count", "squid_deleteApiKey_count", "squid_deleteApiKey_time", "squid_deleteSecret_count", "squid_deleteSecret_time", "squid_discoverGraphQLConnectionSchema_count", "squid_discoverGraphQLConnectionSchema_time", "squid_discoverOpenApiSchema_count", "squid_discoverOpenApiSchema_time", "squid_discoverOpenApiSchemaFromFile_count", "squid_discoverOpenApiSchemaFromFile_time", "squid_executeBackendFunction_count", "squid_executeBackendFunction_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_getAiChatbotProfiles_count", "squid_getAiChatbotProfiles_time", "squid_getAllApiKeys_count", "squid_getAllApiKeys_time", "squid_getAllSecrets_count", "squid_getAllSecrets_time", "squid_getAppApiKey_count", "squid_getAppApiKey_time", "squid_getSecret_count", "squid_getSecret_time", "squid_graphql_count", "squid_graphql_time", "squid_graphqlQuery_count", "squid_graphqlQuery_time", "squid_integrationCount_value", "squid_mutate_count", "squid_mutate_time", "squid_metricQuery_count", "squid_metricQuery_time", "squid_metricReport_count", "squid_metricReport_time", "squid_nativeQuery_count", "squid_nativeQuery_time", "squid_openapi_count", "squid_openapi_time", "squid_produceTopicMessage_count", "squid_produceTopicMessage_time", "squid_query_count", "squid_query_time", "squid_queueMessageHandler_count", "squid_queueMessageHandler_time", "squid_registerQuery_count", "squid_registerQuery_time", "squid_rerankChunks_count", "squid_rerankChunks_time", "squid_schedulerJob_count", "squid_schedulerJob_time", "squid_eventHandler_count", "squid_eventHandler_time", "squid_schema_size", "squid_secrets_entries", "squid_storageDeleteFiles_count", "squid_storageDeleteFiles_time", "squid_storageGetDownloadUrl_count", "squid_storageGetDownloadUrl_time", "squid_storageGetFileMetadata_count", "squid_storageGetFileMetadata_time", "squid_storageListDirectoryContents_count", "squid_storageListDirectoryContents_time", "squid_storageUploadFile_count", "squid_storageUploadFile_time", "squid_subscribeToTopic_count", "squid_subscribeToTopic_time", "squid_tenantDependencyResolved_count", "squid_tenantBrowserSpawnAttempt_count", "squid_testGraphQLConnection_count", "squid_testGraphQLConnection_time", "squid_testAgentProtocolConnection_count", "squid_testAgentProtocolConnection_time", "squid_trigger_count", "squid_trigger_time", "squid_upsertApiKey_count", "squid_upsertApiKey_time", "squid_upsertSecret_count", "squid_upsertSecret_time", "squid_vectorChunks_count", "squid_vectorChunks_time", "squid_webhook_count", "squid_webhook_time", "squid_acquireLock_count", "squid_acquireLock_time", "squid_releaseLock_count", "squid_releaseLock_time"];
-export type MetricName = (typeof ALL_SQUID_METRIC_NAMES)[number];
-/** Common prefix for all Squid metrics. */
-export declare const SQUID_METRIC_NAME_PREFIX = "squid_";

package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts

@@ -1,30 +0,0 @@
-import { ApiOptions } from '../public-types/api-client.public-types';
-import { ApiEndpointId, HttpMethod } from '../public-types/api.public-types';
-import { IntegrationId } from '../public-types/communication.public-types';
-/** The headers of an API call. */
-export type ApiHeaders = Record<string, string | number | boolean>;
-/** The context of an API call. */
-export declare class ApiCallContext {
-    readonly integrationId: IntegrationId;
-    readonly endpointId: ApiEndpointId;
-    readonly url: string;
-    readonly method: HttpMethod;
-    readonly body: unknown;
-    readonly options: ApiOptions;
-}
-/**
- * Represents a request to call an API through a specified integration and endpoint.
- * Includes optional method override and additional request options.
- */
-export interface CallApiRequest<BodyType = any> {
-    /** The identifier of the integration through which the API is called. */
-    integrationId: IntegrationId;
-    /** Target API endpoint to invoke. */
-    endpointId: ApiEndpointId;
-    /** Optional request payload. */
-    body?: BodyType;
-    /** Optional HTTP method override. Default is POST. */
-    overrideMethod?: HttpMethod;
-    /** Additional request options. */
-    options: ApiOptions;
-}