@squidcloud/client 1.0.502 → 1.0.504

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

@@ -1,19 +0,0 @@
-import { MmEntity, MmMatchMaker } from '../public-types/ai-matchmaking.public-types';
-/**
- * Internal-only matchmaking request shapes. Every other request/response of the matchmaking wire
- * contract is declared in `ai-matchmaking.public-types` and imported directly from there.
- */
-export interface MmCreateMatchMakerRequest {
-    matchMaker: MmMatchMaker;
-}
-export interface MmGetMatchMakerRequest {
-    matchMakerId: string;
-}
-export interface MmInsertEntityRequest {
-    matchMakerId: string;
-    entity: MmEntity;
-}
-export interface MmGetEntityRequest {
-    matchMakerId: string;
-    entityId: string;
-}

package/dist/internal-common/src/types/backend-function.types.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/internal-common/src/types/communication.types.d.ts

@@ -1 +0,0 @@
-export type ChatId = string;

package/dist/internal-common/src/types/document.types.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/internal-common/src/types/file.types.d.ts

@@ -1,6 +0,0 @@
-export interface Base64File {
-    filename: string;
-    mimetype: string;
-    base64: string;
-    __isSquidBase64File__: true;
-}

package/dist/internal-common/src/types/headers.types.d.ts

@@ -1,45 +0,0 @@
-/** HTTP header names used by Squid for request metadata. */
-export declare const SquidHeaders: {
-    /** Correlates logs and spans across distributed calls. */
-    readonly TRACE_ID: "x-squid-traceid";
-    /** Shared secret header for internal authentication. */
-    readonly SECRET: "x-squid-secret";
-    /** API key provided by the calling application. */
-    readonly APP_API_KEY: "x-app-api-key";
-    /** Unique identifier of the client application. */
-    readonly APP_ID: "x-squid-appid";
-    /** Unique identifier of the end user or service client. */
-    readonly CLIENT_ID: "x-squid-clientid";
-    /** Version string of the Squid client library. */
-    readonly CLIENT_VERSION: "x-squid-client-version";
-    /**
-     * Access tokens the caller supplies for the request's integrations, as a JSON object keyed by
-     * integration ID. An integration type that runs with one takes it in place of its stored secret.
-     * The header stays in the cores and never reaches tenant code.
-     */
-    readonly INTEGRATION_ACCESS_TOKENS: "x-squid-integration-access-tokens";
-    /**
-     * Response-only: IP of the tenant pod that served the request, i.e. the address to reach it at
-     * again. Core records it to route subsequent affinity-keyed calls to the same pod. Absent when the
-     * pod does not know its own IP.
-     */
-    readonly POD_IP: "x-squid-pod-ip";
-    /**
-     * Response-only: identity of the tenant process that served the request. Distinct from
-     * {@link POD_IP}, which is an address and is reused: Kubernetes hands the IP of a deleted pod to a
-     * new one, so only this value tells core whether it is still talking to the same instance.
-     */
-    readonly INSTANCE_ID: "x-squid-instance-id";
-    /**
-     * Request-only: the {@link INSTANCE_ID} core believes it is calling, sent when routing directly to a
-     * pinned pod instead of through the tenant service. The receiving instance refuses the request when
-     * the value is not its own — the pod at that address may have been replaced, possibly by a pod of a
-     * different application.
-     */
-    readonly EXPECTED_INSTANCE_ID: "x-squid-expected-instance-id";
-    /**
-     * Response-only: key of the tenant worker that served the request, reported separately from
-     * {@link POD_IP} so core alone decides whether to pin at pod or at worker granularity.
-     */
-    readonly WORKER_KEY: "x-squid-worker-key";
-};

package/dist/internal-common/src/types/management-api-key.types.d.ts

@@ -1,92 +0,0 @@
-/**
- * Status lifecycle for management API keys.
- * Keys must be suspended before they can be deleted.
- * @category ManagementApiKey
- */
-export type ManagementApiKeyStatus = 'active' | 'suspended' | 'deleted';
-/**
- * Prefix for all management API keys.
- * Used to identify and validate management keys.
- * @category ManagementApiKey
- */
-export declare const MANAGEMENT_API_KEY_PREFIX = "squid_mgmt_";
-/**
- * Represents a user-level management API key.
- * These keys provide programmatic access to manage organizations and applications
- * where the user is an admin.
- * @category ManagementApiKey
- */
-export interface ManagementApiKey {
-    /** Unique identifier for the API key */
-    id: string;
-    /** The user ID who owns this key */
-    userId: string;
-    /** Optional description for the key */
-    description?: string;
-    /** Current status of the key */
-    status: ManagementApiKeyStatus;
-    /** Timestamp when the key was created */
-    createdAt: Date;
-    /** Timestamp when the key was last updated */
-    updatedAt: Date;
-    /** Timestamp when the key was last used, if ever */
-    lastUsedAt?: Date;
-}
-/**
- * Request to create a new management API key.
- * @category ManagementApiKey
- */
-export interface CreateManagementApiKeyRequest {
-    /** Optional description for the key */
-    description?: string;
-}
-/**
- * Response when creating a new management API key.
- * The keyValue is only returned once during creation.
- * @category ManagementApiKey
- */
-export interface CreateManagementApiKeyResponse {
-    /** The created key metadata */
-    key: ManagementApiKey;
-    /** The raw key value (only returned once during creation) */
-    keyValue: string;
-}
-/**
- * Request to update a management API key's status.
- * @category ManagementApiKey
- */
-export interface UpdateManagementApiKeyRequest {
-    /** The ID of the key to update */
-    keyId: string;
-    /** New status (can only toggle between active and suspended) */
-    status: 'active' | 'suspended';
-}
-/**
- * Request to delete a management API key.
- * The key must be suspended before deletion.
- * @category ManagementApiKey
- */
-export interface DeleteManagementApiKeyRequest {
-    /** The ID of the key to delete */
-    keyId: string;
-}
-/**
- * Response containing a list of user's management API keys.
- * @category ManagementApiKey
- */
-export interface ListManagementApiKeysResponse {
-    /** List of management API keys (without key values) */
-    keys: ManagementApiKey[];
-}
-/**
- * Response from validating a management API key.
- * @category ManagementApiKey
- */
-export interface ValidateManagementApiKeyResponse {
-    /** Whether the key is valid and active */
-    valid: boolean;
-    /** The user ID associated with the key (if valid) */
-    userId?: string;
-    /** The key ID (if valid) */
-    keyId?: string;
-}

package/dist/internal-common/src/types/mutation.types.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/internal-common/src/types/notification.types.d.ts

@@ -1,19 +0,0 @@
-import { ClientId } from '../public-types/communication.public-types';
-import { AiStatusMessageToClient, NotificationMessageToClient } from './socket.types';
-export interface PublishNotificationRequest {
-    clientIds: Array<ClientId>;
-    payload: unknown;
-}
-/**
- * Body of `/notification/publishSystemNotification`: the payload is a ready-made socket message.
- *
- * Deliberately narrower than the `MessageToClient` union: the endpoint exists to carry an AI status
- * update from the backend SDK, or the same message its sibling `publishNotification` produces, and
- * both are read defensively by their consumers. The protocol variants are not accepted — their
- * handlers do structural work on the payload (the SDK's mutation dispatcher iterates it, for
- * example), so admitting them would let a caller hand its own clients a message that throws.
- */
-export interface PublishSystemNotificationRequest {
-    clientIds: Array<ClientId>;
-    payload: AiStatusMessageToClient | NotificationMessageToClient;
-}

package/dist/internal-common/src/types/observability.types.d.ts

@@ -1,296 +0,0 @@
-import { MetricName } from '../metric-name';
-import { AppId } from '../public-types/communication.public-types';
-import { JobId } from '../public-types/job.public-types';
-export interface ObservableNameMetrics {
-    count: MetricName;
-    time: MetricName;
-}
-export declare const ObservableNames: {
-    readonly nativeQuery: ObservableNameMetrics;
-    readonly registerQuery: ObservableNameMetrics;
-    readonly query: ObservableNameMetrics;
-    readonly mutate: ObservableNameMetrics;
-    readonly functionExecution: ObservableNameMetrics;
-    readonly codeInitialization: ObservableNameMetrics;
-    readonly getAiChatbotProfiles: ObservableNameMetrics;
-    readonly aiImageGeneration: ObservableNameMetrics;
-    readonly aiRemoveBackground: ObservableNameMetrics;
-    readonly aiAudioTranscribe: ObservableNameMetrics;
-    readonly aiAudioCreateSpeech: ObservableNameMetrics;
-    readonly aiVoiceCreateSession: ObservableNameMetrics;
-    readonly aiVoiceAnswerOpenAiCall: ObservableNameMetrics;
-    readonly aiVoiceStartOpenAiWebCall: ObservableNameMetrics;
-    readonly aiOpenAiChatCompletions: ObservableNameMetrics;
-    readonly discoverGraphQLConnectionSchema: ObservableNameMetrics;
-    readonly discoverOpenApiSchema: ObservableNameMetrics;
-    readonly discoverOpenApiSchemaFromFile: ObservableNameMetrics;
-    readonly graphqlQuery: ObservableNameMetrics;
-    readonly testGraphQLConnection: ObservableNameMetrics;
-    readonly testAgentProtocolConnection: ObservableNameMetrics;
-    readonly graphql: ObservableNameMetrics;
-    readonly acquireLock: ObservableNameMetrics;
-    readonly releaseLock: ObservableNameMetrics;
-    /**
-     * Timing and count for '/observability/metrics' endpoint calls used to report batch of metrics.
-     */
-    readonly metricReport: ObservableNameMetrics;
-    /**
-     * Timing and count for '/observability/metrics/query' endpoint calls used to query metrics.
-     */
-    readonly metricQuery: ObservableNameMetrics;
-    readonly storageUploadFile: ObservableNameMetrics;
-    readonly storageGetFileMetadata: ObservableNameMetrics;
-    readonly storageGetDownloadUrl: ObservableNameMetrics;
-    readonly storageDeleteFiles: ObservableNameMetrics;
-    readonly storageListDirectoryContents: ObservableNameMetrics;
-    readonly produceTopicMessage: ObservableNameMetrics;
-    readonly subscribeToTopic: ObservableNameMetrics;
-    readonly queueMessageHandler: ObservableNameMetrics;
-    readonly schedulerJob: ObservableNameMetrics;
-    readonly eventHandler: ObservableNameMetrics;
-    readonly webhook: ObservableNameMetrics;
-    readonly openapi: ObservableNameMetrics;
-    readonly executeBackendFunction: ObservableNameMetrics;
-    readonly apiControllerCall: ObservableNameMetrics;
-};
-export type ObservableName = keyof typeof ObservableNames;
-export interface MetricEvent {
-    appId: AppId;
-    name: MetricName;
-    tags: Record<string, string>;
-    timestamp: Date;
-    value: number;
-    isExposedToUser: boolean;
-}
-export interface LogEvent {
-    message: string;
-    level: string;
-    tags: Record<string, string>;
-    timestamp: Date;
-    isExposedToUser: boolean;
-    host: string;
-    source?: string;
-    service?: string;
-}
-export declare const AUDIT_LOG_EVENT_NAMES: readonly ["ai_agent"];
-export type AuditLogEventName = (typeof AUDIT_LOG_EVENT_NAMES)[number];
-export interface AuditLogEvent {
-    appId: AppId;
-    name: AuditLogEventName;
-    timestamp: Date;
-    context: {
-        clientId?: string;
-        userId: string;
-    };
-    tags: Record<string, string>;
-}
-/** Agent audit log entry - one per agent invocation */
-export interface AgentAuditLogEvent {
-    appId: AppId;
-    /** Agent ID (nullable for query-with-AI operations without an agent) */
-    agentId?: string;
-    jobId: string;
-    prompt: string;
-    /** Fully assembled system instructions sent to the LLM; set only when the agent enables auditLogFullContext. */
-    systemInstructions?: string;
-    tags: Record<string, string>;
-    createdAt: Date;
-    /** Integration ID for query-with-AI operations (nullable, used when not invoked via agent) */
-    integrationId?: string;
-}
-export type AgentAuditLogUpdateType = 'statusUpdate' | 'response';
-/** Usage metric for AI model input/output — either token count or character count depending on provider. */
-export interface AiUsageMetric {
-    unit: 'tokens' | 'characters';
-    value: number;
-}
-/** Agent audit log update entry - status updates and responses for agent invocations */
-export interface AgentAuditLogUpdateEvent {
-    appId: AppId;
-    /** Agent ID (nullable for query-with-AI operations without an agent) */
-    agentId?: string;
-    jobId: string;
-    statusUpdateId: string;
-    title: string;
-    parentStatusUpdateId?: string;
-    tags: Record<string, string>;
-    body: string;
-    type: AgentAuditLogUpdateType;
-    createdAt: Date;
-    /** Integration ID for query-with-AI operations (nullable, used when not invoked via agent) */
-    integrationId?: string;
-    /** Input usage metric (tokens or characters depending on provider). */
-    inputUsage?: AiUsageMetric;
-    /** Output usage metric (tokens or characters depending on provider). */
-    outputUsage?: AiUsageMetric;
-    /** Reasoning tokens consumed (where the provider reports them separately from output tokens). */
-    reasoningTokens?: number;
-    /** Number of input tokens served from the provider's prompt cache (read hits). */
-    cacheReadInputTokens?: number;
-    /** Number of input tokens written into the provider's prompt cache (cache misses that created new entries). */
-    cacheWriteInputTokens?: number;
-}
-/** The lane a knowledge-base search arrived through, recorded on its audit entry. */
-export declare const KB_SEARCH_AUDIT_SOURCES: readonly ["sdk", "agent-context", "agent-tool", "internal", "context-search"];
-/** One of {@link KB_SEARCH_AUDIT_SOURCES}. */
-export type KbSearchAuditSource = (typeof KB_SEARCH_AUDIT_SOURCES)[number];
-/**
- * Maximum UTF-8 bytes of any free-text audit payload (agent instructions, retrieved content, tool
- * results, KB query text). Keeps the entry under Kafka's ~1MB message limit with headroom for the rest
- * of the event and JSON escaping.
- */
-export declare const MAX_AUDIT_TEXT_BYTES = 500000;
-/** Truncates a free-text audit payload to {@link MAX_AUDIT_TEXT_BYTES}, marking the cut. */
-export declare function truncateAuditText(text: string): string;
-/**
- * Maximum scopes / contextIds kept on a KB search audit entry. When exceeded, the list is cut and
- * `__truncated` is appended as the final element — the `__` prefix is Squid's reserved scope
- * namespace, so the sentinel can never collide with a real scope or context id from a resolver.
- */
-export declare const MAX_KB_AUDIT_LIST_ENTRIES = 1000;
-/** Final element of a capped scopes/contextIds list on a KB search audit entry. */
-export declare const KB_AUDIT_TRUNCATED_SENTINEL = "__truncated";
-/** Caps an audited scopes/contextIds list, appending the sentinel when entries were dropped. */
-export declare function capKbAuditList(values: ReadonlyArray<string>): Array<string>;
-/**
- * KB retrieval audit entry — one per search of an access-enforced knowledge base, across every
- * search lane. Records what the caller asked, the access scopes they held, and which contexts
- * (documents) the search returned. Only searches on a knowledge base with
- * `accessControl.mode: 'enforced'` produce entries.
- */
-export interface KbSearchAuditLogEvent {
-    appId: AppId;
-    knowledgeBaseId: string;
-    /** The search lane the query arrived through. */
-    source: KbSearchAuditSource;
-    /** The agent the search ran for; absent outside agent jobs. */
-    agentId?: string;
-    /** The agent job the search ran in; absent outside agent jobs. */
-    jobId?: JobId;
-    /** The query text, truncated to {@link MAX_AUDIT_TEXT_BYTES}. */
-    prompt: string;
-    /** Effective retrieval mode (`hybrid` | `vector` | `keyword`; `graph` is refused under enforcement). */
-    searchMode: string;
-    /** Access scopes the caller held for this search (the resolver's output), capped. */
-    scopes: Array<string>;
-    /** Unique context ids of the documents returned to the caller, capped. */
-    contextIds: Array<string>;
-    /** Number of chunks returned (post-limit). */
-    chunkCount: number;
-    durationMs: number;
-    /** Identity tags of the caller: {@link AUDIT_TAG_USER_ID} / auth type / client id / source IP. */
-    tags: Record<string, string>;
-    createdAt: Date;
-}
-/** Tag for metric events. Value: '0' - not an error, '1' - is an error. */
-export declare const O11Y_TAG_IS_ERROR = "isError";
-/** Tag naming the organization an application belongs to. */
-export declare const O11Y_TAG_ORG_ID = "organizationId";
-/** Tag for log events. Metrics have an explicit appId field. */
-export declare const O11Y_TAG_APP_ID = "appId";
-/** Tag for metric and log events. */
-export declare const O11Y_TAG_INTEGRATION_ID = "integrationId";
-/** The integration's own type, which per-type metrics are grouped by. */
-export declare const O11Y_TAG_INTEGRATION_TYPE = "integrationType";
-/** Whether the query also registered a subscription for its result. */
-export declare const O11Y_TAG_SUBSCRIBE = "subscribe";
-/** Tag for AI events. */
-export declare const O11Y_TAG_AI_MODEL = "aiModel";
-export declare const O11Y_TAG_AI_PROFILE = "aiProfile";
-/** Tag for AI KnowledgeBase events */
-export declare const O11Y_TAG_AI_KNOWLEDGE_BASE_MODEL = "aiKnowledgeBaseModel";
-export declare const O11Y_TAG_API_KEY_SOURCE = "apiKeySource";
-/**
- * Whose provider key paid for a call: Squid's own key from Vault, or one the application configured
- * for itself. The axis the AI spend report is built around — left undefined by a caller that cannot
- * tell, never guessed.
- */
-export type AiApiKeySource = 'system' | 'user';
-export declare const O11Y_TAG_AI_JOB_ID = "aiJobId";
-/**
- * Tags for the AI spend ledger (`squid_aiSpend*`). `operation` is the entry path that spent the
- * money (the fixed AiOperation enum), `provider` names who bills for it, and `billingTier` the rate
- * it was charged at — the last of these is an input to the cost calculation, not just a breakdown,
- * since a discounted lane bills at a fraction of the standard list price.
- */
-export declare const O11Y_TAG_AI_OPERATION = "operation";
-export declare const O11Y_TAG_AI_PROVIDER = "provider";
-export declare const O11Y_TAG_AI_BILLING_TIER = "billingTier";
-/**
- * Which population the spend came from: a customer's production app, its dev environment, a
- * developer's sandbox, or a test run. The ledger's own `appId` cannot answer this — it keeps the
- * environment suffix but drops the developer id, so a sandbox and a dev environment arrive under
- * the same app.
- */
-export declare const O11Y_TAG_AI_TRAFFIC_KIND = "trafficKind";
-/**
- * Which stage of a multi-stage lane spent the money, and which pass of its loop produced the call.
- * Set by the query lanes, whose stages re-send the results gathered so far: without them one
- * operation's bill cannot be attributed to the stage that carries the tokens. `iteration` is set
- * only by a lane that loops.
- */
-export declare const O11Y_TAG_AI_SPEND_STAGE = "stage";
-export declare const O11Y_TAG_AI_SPEND_ITERATION = "iteration";
-/** The stages one `query_api` run reports under {@link O11Y_TAG_AI_SPEND_STAGE}. */
-export type AiQueryApiSpendStage = 'endpoint_select' | 'body_create' | 'response_analyze' | 'explanation';
-/** The stages one `query_data` run reports under {@link O11Y_TAG_AI_SPEND_STAGE}. */
-export type AiQueryDataSpendStage = 'select_tables' | 'generate_query' | 'regenerate_queries' | 'clarification' | 'validate_queries' | 'interpreter_check' | 'interpreter_run' | 'results_analysis' | 'raw_result_purpose' | 'readonly_check' | 'spreadsheet_action';
-/**
- * Every stage value the ledger accepts. Enumerated rather than left free-form because the report
- * groups by it: a typo would open a second bucket silently instead of failing to compile.
- */
-export type AiSpendStage = AiQueryApiSpendStage | AiQueryDataSpendStage;
-/**
- * Whether a billed page reached the document it was extracted for. Page-billed spend only: the
- * provider charges for a stale attempt too, so the pages are recorded either way and this separates
- * what was paid for from what was used.
- */
-export declare const O11Y_TAG_AI_PAGES_APPLIED = "pagesApplied";
-/** Tag prefix for client-provided metric annotations (see BaseAiChatOptions.metricAnnotations). */
-export declare const O11Y_TAG_METRIC_ANNOTATION_PREFIX = "annotation.";
-/** Maximum number of AI usage annotation entries kept per call; extra entries are dropped. */
-export declare const MAX_METRIC_ANNOTATIONS = 10;
-/** Maximum length of an AI usage annotation key; longer keys are dropped. */
-export declare const MAX_METRIC_ANNOTATION_KEY_LENGTH = 64;
-/** Maximum length of an AI usage annotation value; longer values are truncated. */
-export declare const MAX_METRIC_ANNOTATION_VALUE_LENGTH = 256;
-/**
- * Sanitizes client-provided metric annotations: caps the number of entries, drops empty or
- * oversized keys, and truncates oversized values. Returns undefined when nothing valid remains.
- */
-export declare function sanitizeMetricAnnotations(annotations: Record<string, string> | undefined): Record<string, string> | undefined;
-/** Tag for metric and log events. Value: '0' - not a tenant originated, '1' - is a tenant originated. */
-export declare const O11Y_TAG_IS_TENANT_ORIGINATED = "isTenantOriginated";
-/** Contains a full (with a service name) function name for backend functions. */
-export declare const O11Y_TAG_FUNCTION_NAME = "functionName";
-/** Contains a type of the function name for backend functions (See ExecuteFunctionAnnotationType.). */
-export declare const O11Y_TAG_FUNCTION_TYPE = "functionType";
-/** Tag for the trace ID. Used in logs. */
-export declare const O11Y_TAG_TRACE_ID = "trace_id";
-/** Tag for the span ID. Used in logs. */
-export declare const O11Y_TAG_SPAN_ID = "span_id";
-/**
- * Tag carrying Squid's own correlation id (the `n_`/`c_` short id minted by
- * `generateTraceId`). Distinct from `trace_id`/`span_id`, which hold the W3C ids from OTel.
- * Rides W3C baggage under the same key on internal hops; attached to spans and logs.
- */
-export declare const O11Y_TAG_SQUID_TRACE_ID = "squid_tid";
-/** How the caller of an audited agent action authenticated; `anonymous` is an unauthenticated request. */
-export type AuditLogAuthType = 'bearer' | 'apiKey' | 'agentApiKey' | 'internal' | 'anonymous';
-/**
- * Agent audit log tag: subject of the caller's bearer token (the application's end user); absent for API-key,
- * agent-key, internal and anonymous callers.
- */
-export declare const AUDIT_TAG_USER_ID = "userId";
-/** Agent audit log tag: {@link AuditLogAuthType} of the caller. */
-export declare const AUDIT_TAG_AUTH_TYPE = "authType";
-/** Agent audit log tag: id of the Squid client that initiated the request. */
-export declare const AUDIT_TAG_CLIENT_ID = "clientId";
-/**
- * Agent audit log tag: IP address the request originated from. Persisted per prompt in the audit log, so it
- * is subject to the same retention as the prompts themselves.
- */
-export declare const AUDIT_TAG_SOURCE_IP = "sourceIp";
-export declare function getBooleanMetricTagValue(value: boolean): string;
-export declare const COUNT_METRIC_SUFFIXES: string[];
-export declare const GAUGE_METRIC_SUFFIXES: string[];

package/dist/internal-common/src/types/query.types.d.ts

@@ -1,21 +0,0 @@
-import { Condition, DocIdCondition, SimpleCondition } from '../public-types/query.public-types';
-/**
- * Whether a LIKE pattern has a backslash before anything but `%`, `_` or another backslash, which is not
- * a valid escape. Executors disagree on what it matches: PostgreSQL reads `\d` as `d`, while Mongo and
- * the local matcher pass it to a regex as a digit.
- */
-export declare function hasInvalidLikeEscape(pattern: string): boolean;
-/**
- * Generates the regex pattern, handling special characters as follows:
- *  - `_` is replaced with a `.`
- *  - `%` is replaced with `[\s\S]*`.
- *  - The above characters can be escaped with \, eg. `\_` is replaced with `_` and `\%` with `%`.
- *  - All special characters in regex (-, /, \, ^, $, *, +, ?, ., (, ), |, [, ], {, }) get escaped with \
- *
- *  Exported for testing purposes.
- * */
-export declare function replaceSpecialCharacters(input: string): string;
-/** Returns true if the condition is a 'SimpleCondition' or false otherwise. */
-export declare function isSimpleCondition(condition: Condition): condition is SimpleCondition;
-/** Returns true if the condition is a 'DocIdCondition' or false otherwise. */
-export declare function isDocIdCondition(condition: Condition): condition is DocIdCondition;

package/dist/internal-common/src/types/secret.types.d.ts

@@ -1,7 +0,0 @@
-import { ApiKeyEntry } from '../public-types/secret.public-types';
-export declare const BACKEND_API_KEY = "_BACKEND_API_KEY";
-export declare const APP_API_KEY = "APP_API_KEY";
-export declare const AGENT_API_HEADER = "x-squid-agent-api-key";
-export interface AgentSecrets {
-    apiKey: ApiKeyEntry | undefined;
-}

package/dist/internal-common/src/types/socket.types.d.ts

@@ -1 +0,0 @@
-export declare const SOCKET_RECONNECT_TIMEOUT: number;

package/dist/internal-common/src/types/stage.d.ts

@@ -1,9 +0,0 @@
-/**
- * Stage of the Squid deployment:
- * - 'local' - Squid is run locally.
- * - 'prod' - Production environment (https://console.getsquid.ai).
- * - 'sandbox' - One of the sandbox environments  (https://console.sandbox.getsquid.ai).
- * - 'staging' - One of the staging environments  (https://console.staging.getsquid.ai).
- */
-export declare const STAGES: readonly ["local", "prod", "sandbox", "staging"];
-export type Stage = (typeof STAGES)[number];

package/dist/internal-common/src/types/time-units.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/internal-common/src/types/url-shortener.types.d.ts

@@ -1,45 +0,0 @@
-import { AppId } from '../public-types/communication.public-types';
-/**
- * Request to create a shortened URL.
- */
-export interface ShortUrlRequest {
-    /** The URL to shorten. It must be a valid URL and should include the protocol (start with http:// or https://). */
-    url: string;
-    /** The application ID that will own this shortened URL. */
-    appId: AppId;
-    /** Seconds to live for the shortened URL. If set to 0, the URL will never expire. Defaults to 1 day. */
-    secondsToLive?: number;
-    /** Optional file extension to include in the shortened URL ID (e.g., 'pdf', 'html'). The extension becomes part of the ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
-    fileExtension?: string;
-}
-/**
- * Request to create shortened URLs.
- */
-export interface ShortUrlBulkRequest {
-    /** The URLs to shorten. They must be valid URLs and should include the protocol (start with http:// or https://). */
-    urls: string[];
-    /** The application ID that will own these shortened URLs. */
-    appId: AppId;
-    /** Seconds to live for all shortened URLs. If set to 0, the URLs will never expire. Defaults to 1 day. */
-    secondsToLive?: number;
-    /** Optional file extension to include in all shortened URL IDs (e.g., 'pdf', 'html'). The extension becomes part of each ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
-    fileExtension?: string;
-}
-/**
- * Request to delete a shortened URL.
- */
-export interface ShortUrlDeleteRequest {
-    /** The ID of the shortened URL to delete. */
-    id: string;
-    /** The application ID that owns the shortened URL. */
-    appId: AppId;
-}
-/**
- * Request to delete a shortened URL.
- */
-export interface ShortUrlBulkDeleteRequest {
-    /** The IDs of the shortened URLs to delete. */
-    ids: string[];
-    /** The application ID that owns the shortened URLs. */
-    appId: AppId;
-}

package/dist/internal-common/src/utils/array.d.ts

@@ -1,7 +0,0 @@
-export declare function truncateOrPadArray(arr: number[], length: number): number[];
-/**
- * Computes a single “recommended” chunk size so that if you loop
- * `for (let i = 0; i < length; i += chunkSize)`,
- * no slice will exceed `maxChunkSize` and all chunk sizes are 'almost' equal.
- */
-export declare function computeRecommendedChunkSize(length: number, maxChunkSize: number): number;

package/dist/internal-common/src/utils/connector-path-status.d.ts

@@ -1,27 +0,0 @@
-/**
- * The registry of connectors that support path-status search, plus the shared dispatch logic that
- * calls the right one by integration type. `ExecuteFunctionLike` duck-types the subset of
- * `@squidcloud/client`'s `Squid` this needs; see `SquidServiceLike` in `./squid-service.utils` for
- * the same pattern.
- */
-import { IntegrationId } from '../public-types/communication.public-types';
-import { ConnectorPathStatusResult } from '../public-types/connector.public-types';
-import { IntegrationType } from '../public-types/integration.public-types';
-/** How to call one connector's `get<X>PathStatus` executable: its name and its calling convention. */
-export interface PathStatusExecutable {
-    functionName: string;
-    buildArgs: (integrationId: IntegrationId, path: string) => Array<unknown>;
-}
-/** Absent for a type ⇒ that connector doesn't track file/folder hierarchy beyond the KB ledger. */
-export declare const PATH_STATUS_EXECUTABLE_BY_TYPE: Partial<Record<IntegrationType, PathStatusExecutable>>;
-/** The subset of `Squid` (`@squidcloud/client`) this dispatch needs. */
-export interface ExecuteFunctionLike {
-    executeFunction<T>(functionName: string, ...args: Array<unknown>): Promise<T>;
-}
-/**
- * Searches a connector's own record of files/folders at a path, for connectors registered in
- * {@link PATH_STATUS_EXECUTABLE_BY_TYPE}. Returns `{ supported: false }` when `integrationType` isn't
- * registered — most integration types don't support this, and that's not an error. The caller (e.g.
- * `IntegrationClient.getPathStatus`) already has the integration, so this doesn't re-fetch it.
- */
-export declare function getConnectorPathStatus(executor: ExecuteFunctionLike, integrationType: IntegrationType, integrationId: IntegrationId, path: string): Promise<ConnectorPathStatusResult>;

package/dist/internal-common/src/utils/e2e-test-utils.d.ts

@@ -1,2 +0,0 @@
-/** Returns true if the application is run by a Playwright test. */
-export declare function isPlaywrightTestMode(): boolean | undefined;

package/dist/internal-common/src/utils/file-utils.d.ts

@@ -1,2 +0,0 @@
-/** Gets file extension from filename. */
-export declare function getFileExtension(filename: string): string | undefined;

package/dist/internal-common/src/utils/global.utils.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/internal-common/src/utils/http-utils.d.ts

@@ -1,15 +0,0 @@
-import { ObjectAssertion } from 'assertic';
-import { HttpStatusCode } from '../public-types/http-status.public-types';
-export type HttpQueryParams = Record<string, string | number | boolean>;
-/**
- * Asserts that a value is truthy. Throws a {@link ValidationError} with the given HTTP status code if it is not.
- * Narrows the type of `value` to exclude `null`, `undefined`, `false`, `0`, and `''`.
- */
-export declare function assertHttp<T>(value: T, message: string, status: HttpStatusCode): asserts value is NonNullable<T> & (T extends false | 0 | '' ? never : T);
-/**
- * Asserts that an object matches the given ObjectAssertion.
- * Re-throws any non-ValidationError as BAD_REQUEST.
- */
-export declare function assertHttpInput<T>(value: T, assertion: ObjectAssertion<T>): asserts value is T;
-/** Builds a query string from the record of key-value pairs. */
-export declare function buildHttpQueryString(queryParams: HttpQueryParams): string;