@squidcloud/client 1.0.489 → 1.0.491

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

@@ -10,6 +10,14 @@ export declare const SOURCE_CODE_MAX_SUPPLEMENTAL_INSTRUCTIONS_LENGTH = 20000;
 export declare const SOURCE_CODE_ANALYZER_MODELS: readonly ["claude-code", "codex"];
 /** Identifies a CLI provider available for source-code analysis. */
 export type SourceCodeAnalyzerModel = (typeof SOURCE_CODE_ANALYZER_MODELS)[number];
+/** Lists trusted source-cache lifecycle strategies. */
+export declare const SOURCE_CODE_CACHE_STRATEGIES: readonly ["reuse", "recreate"];
+/** Selects how source analysis manages its pod-local trusted cache. */
+export type SourceCodeCacheStrategy = (typeof SOURCE_CODE_CACHE_STRATEGIES)[number];
+/** Lists the repository capabilities available to the configured CLI agent. */
+export declare const SOURCE_CODE_EXECUTION_MODES: readonly ["read-only", "write"];
+/** Selects whether the configured CLI agent may modify and publish repository state. */
+export type SourceCodeExecutionMode = (typeof SOURCE_CODE_EXECUTION_MODES)[number];
 /** Lists supported source-control providers. */
 export declare const SOURCE_CONTROL_PROVIDERS: readonly ["github", "bitbucket"];
 /** Identifies a supported source-control provider. */
@@ -30,6 +38,10 @@ export interface AiAgentSourceCodeIntegrationOptions {
     analyzerReasoningEffort?: CanonicalReasoningEffort;
     /** Provides supplemental code-analysis instructions. */
     analyzerInstructions?: string;
+    /** Reuses the pod-local trusted cache by default or recreates it for every analysis. */
+    cacheStrategy?: SourceCodeCacheStrategy;
+    /** Inspects repositories by default or enables unrestricted repository work. */
+    executionMode?: SourceCodeExecutionMode;
 }
 /** Stores the immutable GitHub identity and access metadata for a selected repository. */
 export interface GitHubRepositoryConfiguration {

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

@@ -19,6 +19,14 @@ export interface UpsertContextsOptions {
      */
     onUploaded?: () => void;
 }
+/**
+ * Options for retrieving a knowledge base context.
+ * @category AI
+ */
+export interface GetContextOptions {
+    /** The number of characters after which text is truncated. Optional */
+    truncateTextAfter?: number;
+}
 /**
  * A reference to an AI knowledge base.
  */
@@ -73,9 +81,11 @@ export declare class AiKnowledgeBaseReference {
      */
     listContextIds(): Promise<Array<AiContextId>>;
     /**
-     * Retrieves a specific context by its ID.
+     * Retrieves a specific context by its ID. Pass `truncateTextAfter: 0` to omit the context's `text`
+     * field from the response when only its metadata (e.g. `contentHash`) is needed — the stored text
+     * can be multiple MB, and truncating it avoids sending that payload back in full.
      */
-    getContext(contextId: string): Promise<AiKnowledgeBaseContext | undefined>;
+    getContext(contextId: string, options?: GetContextOptions): Promise<AiKnowledgeBaseContext | undefined>;
     /**
      * Deletes a specific context by its ID.
      */
@@ -84,6 +94,20 @@ export declare class AiKnowledgeBaseReference {
      * Deletes multiple contexts.
      */
     deleteContexts(contextIds: Array<string>): Promise<void>;
+    /**
+     * Replaces the access scopes that grant read access to a context.
+     *
+     * Only meaningful on a knowledge base with `accessControl.mode: 'enforced'`: a search then returns a
+     * context only when the caller holds at least one of its scopes. Passing an empty array makes the
+     * context visible to every caller.
+     *
+     * The refresh primitive for permissions that changed at the source without the document itself
+     * changing. Pass `scopes` on the upsert instead when ingesting, so a restricted context is never
+     * briefly readable by everyone.
+     *
+     * @returns how many of the context's chunks were rewritten.
+     */
+    setContextScopes(contextId: string, scopes: Array<string>): Promise<number>;
     /**
      * Adds or updates a single context.
      */
@@ -164,12 +188,16 @@ export declare class AiKnowledgeBaseReference {
      * spreadsheet rows verbatim, and matches characters rather than meaning. The pattern is always a
      * literal — regex metacharacters in it are escaped — and matching is case-insensitive.
      * `options.metadataFilter` scopes the scan to the contexts it admits before any text is matched.
+     * Refused on a knowledge base with `accessControl.mode: 'enforced'` — the raw text carries no access
+     * scopes, so the scan cannot be filtered per caller.
      */
     grep(pattern: string, options?: GrepKnowledgeBaseOptions): Promise<GrepKnowledgeBaseResponse>;
     /**
      * 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.
+     * 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.
      */
     queryGraph(request: Omit<QueryKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<QueryKnowledgeBaseGraphResponse>;
     /**

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

@@ -8,19 +8,36 @@ export declare class IntegrationClient {
     private readonly rpcManager;
     private readonly iacBaseUrl;
     /**
-     * Lists all integrations for the current application.
+     * Lists all enabled integrations for the current application.
      *
      * @param type - (Optional) Filter by integration type.
+     * @param options - (Optional) Pass `includeDisabled: true` to also list disabled integrations.
      * @returns A promise that resolves with a list of integrations.
      */
-    list<ConfigurationType = Record<string, any>>(type?: IntegrationType): Promise<Array<IntegrationInfo<ConfigurationType>>>;
+    list<ConfigurationType = Record<string, any>>(type?: IntegrationType, options?: ListIntegrationsOptions): Promise<Array<IntegrationInfo<ConfigurationType>>>;
     /**
-     * Retrieves the integration by its ID.
+     * Retrieves the integration by its ID. Disabled integrations are returned too - check the
+     * `enabled` field of the result (`false` means disabled).
      *
      * @param integrationId - The ID of the integration to retrieve.
      * @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>;
+    /**
+     * Enables a disabled integration. The integration becomes available again for runtime access and sync jobs.
+     *
+     * @param integrationId - The ID of the integration to enable.
+     * @returns A promise that resolves when the integration has been enabled.
+     */
+    enable(integrationId: IntegrationId): Promise<void>;
+    /**
+     * Disables an integration. Runtime access is rejected and sync jobs skip it until it is enabled again.
+     *
+     * @param integrationId - The ID of the integration to disable.
+     * @returns A promise that resolves when the integration has been disabled.
+     */
+    disable(integrationId: IntegrationId): Promise<void>;
+    private setEnabled;
     /**
      * Retrieves the integration's schema by its ID.
      *
@@ -142,6 +159,16 @@ export declare class IntegrationClient {
      */
     discoverOpenApiSchemaFromFile<SchemaType = Record<string, any>>(integrationId: IntegrationId): Promise<DiscoverOpenApiSchemaResponse<SchemaType>>;
 }
+/**
+ * Options for listing integrations.
+ * @category Platform
+ */
+export interface ListIntegrationsOptions {
+    /**
+     * When true, disabled integrations are included in the result. By default only enabled integrations are returned.
+     */
+    includeDisabled?: boolean;
+}
 /**
  * Request for generating AI descriptions for a data schema.
  * @category Platform

package/dist/typescript-client/src/query-utils.d.ts

@@ -10,12 +10,24 @@ export interface VisitQueryResultsStats {
     /** Time in millis spent in the function. */
     time: number;
 }
+/**
+ * Progress of a paginated read, reported once per loaded page.
+ * @category Database
+ */
+export interface PageProgress {
+    /** Zero-based index of the page just loaded. */
+    pageIndex: number;
+    /** Number of documents on that page, which the last page makes smaller than the requested size. */
+    documentCount: number;
+    /** Number of documents loaded so far, this page included. */
+    totalLoaded: number;
+}
 /**
  * Reads all objects from the query in a safe way (with pagination) and calls callback() on every object.
  * The iteration is interrupted if error is thrown.
  * @category Database
  */
-export declare function visitQueryResults<T extends DocumentData>(query: QueryBuilder<T>, callback: (t: T) => Promise<unknown>, pageSize?: number): Promise<VisitQueryResultsStats>;
+export declare function visitQueryResults<T extends DocumentData>(query: QueryBuilder<T>, callback: (t: T) => Promise<unknown>, pageSize?: number, onPageLoaded?: (progress: PageProgress) => void): Promise<VisitQueryResultsStats>;
 /**
  * Paginates through the query and returns the docIds of all matching documents in a form
  * that can be passed back to `collection.doc(id)` to retrieve the same documents. Does
@@ -38,4 +50,4 @@ export declare function visitQueryResults<T extends DocumentData>(query: QueryBu
  *
  * @category Database
  */
-export declare function loadQueryResultDocIds<T extends DocumentData>(query: QueryBuilder<T>, pageSize?: number): Promise<Array<DocIdOrDocIdObj>>;
+export declare function loadQueryResultDocIds<T extends DocumentData>(query: QueryBuilder<T>, pageSize?: number, onPageLoaded?: (progress: PageProgress) => void): Promise<Array<DocIdOrDocIdObj>>;

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

package/package.json

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