@squidcloud/client 1.0.481 → 1.0.483

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/dist/cjs/index.js +1 -1
  2. package/dist/esm/index.js +1 -1
  3. package/dist/internal-common/src/public-types/ai-agent-integrations.public-types.d.ts +7 -0
  4. package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts +32 -0
  5. package/dist/internal-common/src/public-types/ai-common.public-types.d.ts +4 -4
  6. package/dist/internal-common/src/public-types/ai-knowledge-base.public-types.d.ts +655 -4
  7. package/dist/internal-common/src/public-types/ai-matchmaking.public-types.d.ts +4 -3
  8. package/dist/internal-common/src/public-types/ai-query.public-types.d.ts +6 -0
  9. package/dist/internal-common/src/public-types/connector.public-types.d.ts +1 -1
  10. package/dist/internal-common/src/public-types/extraction.public-types.d.ts +120 -1
  11. package/dist/internal-common/src/public-types/integration.public-types.d.ts +1 -1
  12. package/dist/internal-common/src/public-types/langgraph.public-types.d.ts +40 -0
  13. package/dist/internal-common/src/public-types/metadata-filter.public-types.d.ts +6 -2
  14. package/dist/internal-common/src/public-types/web.public-types.d.ts +5 -0
  15. package/dist/typescript-client/src/ai-knowledge-base/ai-knowledge-base-client-reference.d.ts +34 -1
  16. package/dist/typescript-client/src/index.d.ts +1 -0
  17. package/dist/typescript-client/src/langgraph-client.d.ts +62 -0
  18. package/dist/typescript-client/src/public-types.d.ts +1 -0
  19. package/dist/typescript-client/src/squid.d.ts +6 -0
  20. package/dist/typescript-client/src/version.d.ts +1 -1
  21. package/dist/typescript-client/src/web-client.d.ts +12 -1
  22. package/package.json +1 -1
@@ -1,3 +1,4 @@
1
+ import { AiAgentMemoryOptions } from './ai-agent.public-types';
1
2
  import { AiQueryOptions } from './ai-query.public-types';
2
3
  import { AiAgentId } from './communication.public-types';
3
4
  /**
@@ -41,6 +42,12 @@ export interface AiApiOptions {
41
42
  * user prompt. Default 4.
42
43
  */
43
44
  maxIterations?: number;
45
+ /**
46
+ * Conversation memory configuration. When provided, prior user prompts and AI answers under the same `memoryId`
47
+ * are provided as additional context to the AI, enabling cross-prompt follow-ups
48
+ * Defaults to no memory.
49
+ */
50
+ memoryOptions?: AiAgentMemoryOptions;
44
51
  }
45
52
  /**
46
53
  * Configuration options for AI agent MCP integration.
@@ -715,6 +715,13 @@ export declare const AGENT_STATUS_TITLE_CALLING_AI_FUNCTION = "Calling AI Functi
715
715
  * @category AI
716
716
  */
717
717
  export declare const AGENT_STATUS_TITLE_INSPECTING_KB_METADATA = "Inspecting Knowledge Base Metadata";
718
+ /**
719
+ * Status update title broadcast when the agent invokes the knowledge-graph query callable (offered
720
+ * automatically for graph-enabled KBs). Distinct from {@link AGENT_STATUS_TITLE_ACCESSING_KB} so a
721
+ * caller can tell graph navigation apart from an ordinary KB search.
722
+ * @category AI
723
+ */
724
+ export declare const AGENT_STATUS_TITLE_QUERYING_KB_GRAPH = "Querying Knowledge Base Graph";
718
725
  /**
719
726
  * Status update title broadcast when the agent queries a spreadsheet file callable.
720
727
  * @category AI
@@ -836,6 +843,12 @@ export interface BaseUpsertContextStatus {
836
843
  export interface UpsertContextStatusSuccess extends BaseUpsertContextStatus {
837
844
  /** Whether the context upsert was successful or got an error. */
838
845
  status: 'success';
846
+ /**
847
+ * Set when the context was stored and is fully searchable (vector/keyword), but was NOT graph-indexed
848
+ * because the knowledge base is over its per-KB graph chunk cap. Only GraphRAG coverage is absent;
849
+ * surfaced so bulk operations can report which contexts fell outside the graph.
850
+ */
851
+ graphIndexingSkipped?: boolean;
839
852
  }
840
853
  /**
841
854
  * Machine-readable code identifying a specific upsert failure reason.
@@ -845,6 +858,19 @@ export interface UpsertContextStatusSuccess extends BaseUpsertContextStatus {
845
858
  * @category AI
846
859
  */
847
860
  export type UpsertContextErrorCode = 'DUPLICATE_CONTENT';
861
+ /**
862
+ * The existing context a `DUPLICATE_CONTENT` rejection points at — where the byte-identical original
863
+ * already lives.
864
+ * @category AI
865
+ */
866
+ export interface UpsertContextDuplicateOf {
867
+ /** The id of the already-stored context whose content is byte-identical to the rejected request. */
868
+ contextId: string;
869
+ /** The existing context's source reference (file name / URL), when it has one. */
870
+ reference?: string;
871
+ /** The existing context's `folderPath` metadata, when it was ingested with a folder path. */
872
+ folderPath?: string;
873
+ }
848
874
  /**
849
875
  * Status of an individual context item after it failed to upsert.
850
876
  *
@@ -858,6 +884,12 @@ export interface UpsertContextStatusError extends BaseUpsertContextStatus {
858
884
  errorMessage: string;
859
885
  /** Machine-readable code for the failure, when one applies. */
860
886
  errorCode?: UpsertContextErrorCode;
887
+ /**
888
+ * The existing context this request duplicated, when `errorCode` is `DUPLICATE_CONTENT`. Lets a caller
889
+ * point the user at where the original already lives (e.g. its folder) instead of only reporting the
890
+ * rejection. `reference`/`folderPath` are present when the existing context carries them.
891
+ */
892
+ duplicateOf?: UpsertContextDuplicateOf;
861
893
  }
862
894
  /**
863
895
  * Status of an individual context item after attempting to upsert it.
@@ -8,7 +8,7 @@ export declare const RERANK_PROVIDERS: readonly ["cohere", "none"];
8
8
  */
9
9
  export type AiRerankProvider = (typeof RERANK_PROVIDERS)[number];
10
10
  /** List of available AI provider types. See AiProviderType. */
11
- export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "bedrock", "claude-code", "codex", "cohere", "flux", "gemini", "openai", "grok", "stability", "voyage", "mistral", "textract", "vertex", "external"];
11
+ export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "bedrock", "claude-code", "codex", "cohere", "flux", "gemini", "openai", "openai-compatible", "grok", "stability", "voyage", "mistral", "textract", "vertex", "external"];
12
12
  /**
13
13
  * Type of the AI provider.
14
14
  * References a single AI service, regardless of the model or other AI function it provides (like
@@ -29,7 +29,7 @@ export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4
29
29
  * Public Gemini chat model names (active models only).
30
30
  * @category AI
31
31
  */
32
- export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3.1-pro", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
32
+ export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3.1-pro", "gemini-3.6-flash", "gemini-3.5-flash-lite"];
33
33
  /**
34
34
  * Public Grok chat model names (active models only).
35
35
  * @category AI
@@ -39,12 +39,12 @@ export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.3", "grok-4-1-fast
39
39
  * Public Anthropic chat model names (active models only).
40
40
  * @category AI
41
41
  */
42
- export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-20251001", "claude-opus-4-8", "claude-sonnet-5"];
42
+ export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-20251001", "claude-opus-5", "claude-sonnet-5"];
43
43
  /**
44
44
  * The supported AI model names.
45
45
  * @category AI
46
46
  */
47
- export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.5", "gpt-5.5-pro", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "claude-haiku-4-5-20251001", "claude-opus-4-8", "claude-sonnet-5", "gemini-3.1-pro", "gemini-3.5-flash", "gemini-3.1-flash-lite", "grok-4.3", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
47
+ export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.5", "gpt-5.5-pro", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "claude-haiku-4-5-20251001", "claude-opus-5", "claude-sonnet-5", "gemini-3.1-pro", "gemini-3.6-flash", "gemini-3.5-flash-lite", "grok-4.3", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
48
48
  /** Checks if the given model name is a global AI chat model name. */
49
49
  export declare function isVendorAiChatModelName(modelName: unknown): modelName is VendorAiChatModelName;
50
50
  /**