@ganju/utils 0.0.14 → 0.0.16

package/dist/constants.js

@@ -104,6 +104,10 @@ const OAUTH_TOKEN_URLS = {
 // expire mid-flight. Shared by every credential-refresh path (native OAuth and
 // MCP-proxy OAuth, in both apps/api and apps/mcp).
 const CREDENTIAL_REFRESH_BUFFER_MS = 60 * 1000;
+// A refresh the token endpoint rejects (4xx) without a reauth code still flags
+// the credential once its access token has been expired this long, so the
+// owner sees it as expired instead of every call failing behind "Connected".
+const CREDENTIAL_REFRESH_GIVE_UP_MS = 60 * 60 * 1000;
 const GOOGLE_CALENDAR_API_BASE = 'https://www.googleapis.com/calendar/v3';
 const GOOGLE_DRIVE_API_BASE = 'https://www.googleapis.com/drive/v3';
 const GOOGLE_DRIVE_DEFAULT_PAGE_SIZE = 200;
@@ -167,7 +171,17 @@ const ONE_DRIVE_TAB_LABELS = [
     { value: ONE_DRIVE_TAB_RECENT, label: ONE_DRIVE_TAB_LABEL_RECENT },
     { value: ONE_DRIVE_TAB_DRIVES, label: ONE_DRIVE_TAB_LABEL_DRIVES }
 ];
-const REAUTH_ERROR_CODES = ['invalid_grant', 'invalid_token'];
+// Token-endpoint error codes that mean the stored refresh token is dead and
+// only a reconnect brings it back. `unauthorized_client` is Google's answer
+// when a token no longer belongs to the app it is refreshed with.
+const REAUTH_ERROR_CODES = [
+    'invalid_grant',
+    'invalid_token',
+    'unauthorized_client'
+];
+// Token-endpoint error codes that are about our own client id / secret, not
+// the user's token: a reconnect can't fix them, so they never flag one.
+const OAUTH_CLIENT_ERROR_CODES = ['invalid_client'];
 const RESOURCE_TYPE_TOOLTIP_MIN_WIDTH = 300;
 const SEARCH_DEBOUNCE_MS = 300;
 const SCHEMA_DEFINITION_TYPES = [
@@ -252,6 +266,9 @@ const CRAWL_MAX_PAGES_LIMIT = 1000;
 const CRAWL_DEFAULT_MAX_DEPTH = 3;
 const CRAWL_MAX_DEPTH_LIMIT = 10;
 const CRAWL_PAGE_FETCH_TIMEOUT_MS = 30000;
+// Redirects one crawl fetch may follow. Each hop is screened on its own, so a
+// public URL can't bounce the crawler onto a private address.
+const CRAWL_MAX_REDIRECTS = 5;
 const CRAWL_USER_AGENT = 'Mozilla/5.0 (compatible; GanjuCrawler/1.0; +https://ganju.ai)';
 const CRAWL_PAGE_QUEUE_BATCH_SIZE = 100;
 const RESOURCE_ICON_THEME_DARK = 'dark';
@@ -484,6 +501,10 @@ const RATE_LIMIT_BACKOFF_SECONDS = 60;
 // Short backoff for transient Cloudflare platform errors (e.g. a Durable Object
 // / Container reset) so the retried job lands after the object has recovered.
 const TRANSIENT_BACKOFF_SECONDS = 5;
+// Retries every resource queue consumer is configured with (`max_retries` in
+// the API worker's wrangler config). A job's last delivery is attempt
+// QUEUE_MAX_RETRIES + 1; only then is its work marked failed.
+const QUEUE_MAX_RETRIES = 3;
 const CHANNEL_PLATFORM_TELEGRAM = 'telegram';
 const CHANNEL_PLATFORM_SLACK = 'slack';
 const CHANNEL_PLATFORM_WHATSAPP = 'whatsapp';
@@ -667,14 +688,37 @@ const TOOL_CONFIRMATION_ASK_INSTRUCTION = 'IMPORTANT: these actions have NOT bee
     'confirm, and must not say or suggest that they were done, nor describe ' +
     'or make up any result from them.';
 // For MCP clients, whose chat the server can't see: a sensitive call without a
-// valid confirmation isn't run, and the model is told to ask the user and call
-// again with a token that binds the second call to these exact arguments.
-// How long that token stays good, and the argument that carries it.
+// valid confirmation isn't run. Ordinarily the model is told to ask the user
+// and call again with a token that binds the second call to these exact
+// arguments; once the session has read outside content, the user approves it
+// on a dashboard page instead, and the second call carries that approval's
+// id. How long either stays good, and the argument that carries it.
 const MCP_TOOL_CONFIRMATION_TTL_MS = 10 * 60 * 1000;
 const MCP_TOOL_CONFIRMATION_ARG = 'confirmation';
 const MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION = "Leave out on the first call. This action needs the user's yes: the " +
-    'first call returns a token; after the user says yes, call again with the ' +
-    'same arguments and that token here.';
+    'first call returns a code and says how to get that yes; once the user ' +
+    'has given it, call again with the same arguments and that code here.';
+// The same argument where only some calls ask: those made after the session
+// read outside content.
+const MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION_CONDITIONAL = "Leave out on the first call. If this action needs the user's yes, the " +
+    'first call returns a code instead of running and says how to get that ' +
+    'yes; once the user has given it, call again with the same arguments and ' +
+    'that code here.';
+// The dashboard page where a signed-in user approves or denies one such call,
+// as `${TOOL_APPROVAL_PATH}/<approval id>`, and the two answers it sends.
+const TOOL_APPROVAL_PATH = '/tool-approval';
+const TOOL_APPROVAL_DECISION_APPROVE = 'approve';
+const TOOL_APPROVAL_DECISION_DENY = 'deny';
+const TOOL_APPROVAL_DECISIONS = [
+    TOOL_APPROVAL_DECISION_APPROVE,
+    TOOL_APPROVAL_DECISION_DENY
+];
+// Where an approval stands, as the page shows it.
+const TOOL_APPROVAL_STATUS_PENDING = 'pending';
+const TOOL_APPROVAL_STATUS_APPROVED = 'approved';
+const TOOL_APPROVAL_STATUS_DENIED = 'denied';
+const TOOL_APPROVAL_STATUS_USED = 'used';
+const TOOL_APPROVAL_STATUS_EXPIRED = 'expired';
 // The question when the model wrote none, above the runner's own summary.
 const TOOL_CONFIRMATION_FALLBACK_QUESTION = 'Before I do this, please confirm. Reply yes to go ahead, or no to cancel.';
 const TELEGRAM_SECRET_HEADER = 'x-telegram-bot-api-secret-token';
@@ -695,13 +739,15 @@ const SLACK_MESSAGE_LIMIT = 2900;
 const SLACK_MAX_SOURCE_BUTTONS = 10;
 // The Slack app configuration Ganju needs, surfaced in the UI when connecting a
 // Slack channel. Required scopes back the runner's calls (mentions, DMs,
-// posting, file upload); recommended scopes only enrich names/titles and
-// degrade gracefully; bot events are what the webhook subscribes to.
+// posting, file upload, downloading a voice clip to transcribe it);
+// recommended scopes only enrich names/titles and degrade gracefully; bot
+// events are what the webhook subscribes to.
 const SLACK_REQUIRED_SCOPES = [
     'app_mentions:read',
     'im:history',
     'chat:write',
-    'files:write'
+    'files:write',
+    'files:read'
 ];
 const SLACK_RECOMMENDED_SCOPES = ['users:read', 'channels:read', 'groups:read'];
 const SLACK_BOT_EVENTS = ['app_mention', 'message.im'];
@@ -808,12 +854,29 @@ const RESOURCE_SEARCH_RRF_K = 60;
 // keeps its words.
 const RESOURCE_SEARCH_COMMON_TERM_DIVISOR = 10;
 const RESOURCE_SEARCH_COMMON_TERM_MIN = 5;
-// Second stage, on wherever the Worker has an AI binding: the top fused
-// candidates are re-scored by a cross-encoder, which reads query and chunk
-// together instead of comparing two independently computed vectors. One model
-// call per search; a failure falls back to the fused order.
+// Second stage: the top fused candidates re-scored by a cross-encoder, which
+// reads query and chunk together instead of comparing two independently
+// computed vectors. One model call per search; a failure falls back to the
+// fused order. Off by default: on the golden sets (Spanish and English) the
+// fused order matched or beat it on every set — 10 cases better, 5 worse — and
+// it added 0.5–0.9 s a search plus a ~6 s cold start. The search eval can
+// still turn it on per request to re-measure.
+const RESOURCE_SEARCH_RERANK_ENABLED = false;
 const RESOURCE_SEARCH_RERANK_CANDIDATES = 30;
 const RESOURCE_SEARCH_RERANK_MODEL = '@cf/baai/bge-reranker-base';
+// An identifier in the query (a code mixing letters and digits, a snake_case
+// name, or a number, dotted or hyphenated name typed on its own) found in at
+// most this many documents is what the user is after: its chunks go first,
+// whatever the reranker thinks. A cross-encoder reads "86400" or "PGRST116" as noise and
+// would bury the one chunk that contains it under pages that merely look
+// related. Past EXACT_MAX_CHUNKS matching chunks the identifier is common
+// enough that the usual ranking is left to decide, and the scan stops there.
+const RESOURCE_SEARCH_EXACT_MAX_RESOURCES = 5;
+const RESOURCE_SEARCH_EXACT_MAX_CHUNKS = 30;
+// An identifier the index never saw is looked for as plain text, which reads
+// every chunk of the artifact when nothing matches. Past this many chunks that
+// costs more than the rare hit is worth, so a large artifact skips it.
+const RESOURCE_SEARCH_SUBSTRING_MAX_CHUNKS = 20000;
 const RESOURCE_HANDLER_SLEEP_AFTER = '10m';
 const DOCS_URL = 'https://ganju.ai/docs/';
 const BASE64_DATA_URI_RE = /data:image\/[a-zA-Z0-9+\-.]+;base64,[A-Za-z0-9+/=\s]+/g;
@@ -826,6 +889,11 @@ const CHUNK_SEPARATORS = [
     { split: ' ', join: ' ' }
 ];
 const DEFAULT_MAX_TOKENS = 4096;
+// One page of `list-resources`. A knowledge base with a crawled site runs to
+// thousands of resources; listed whole, that is one result of several hundred
+// KB in the model's context.
+const LIST_RESOURCES_DEFAULT_LIMIT = 100;
+const LIST_RESOURCES_MAX_LIMIT = 500;
 const RESOURCE_TOOL_KEY_LIST_RESOURCES = 'list-resources';
 const RESOURCE_TOOL_KEY_SEARCH_RESOURCES = 'search-resources';
 const RESOURCE_TOOL_KEY_READ_RESOURCE = 'read-resource';
@@ -1288,7 +1356,9 @@ const RESERVED_TOOL_NAMES = [
     TOOL_DEFINITION_KEY_HTTP_ENDPOINT,
     TOOL_DEFINITION_KEY_MCP_PROXY,
     TOOL_DEFINITION_KEY_CUSTOM_CODE,
-    sdkConstants_1.CUSTOM_CODE_HEALTH_TOOL
+    sdkConstants_1.CUSTOM_CODE_HEALTH_TOOL,
+    // The channel runner's own memory tool (PARTICIPANT_MEMORY_TOOL_NAME).
+    'remember-customer'
 ];
 // Shared by both write paths so there is one string to translate. It has to
 // carry a word `matchStatus` recognises (errorHandler.ts), because the
@@ -1516,8 +1586,16 @@ const MCP_AUTH_KIND_INTERNAL = 'internal';
 const MCP_AUTH_KINDS = [MCP_AUTH_KIND_JWT, MCP_AUTH_KIND_INTERNAL];
 const MCP_SESSION_HEADER = 'mcp-session-id';
 const MCP_INTERNAL_HEADER = 'x-ganju-internal-secret';
+// Sent with the internal secret by the search eval to measure the reranker:
+// `on` or `off` overrides RESOURCE_SEARCH_RERANK_ENABLED for that request.
+// Ignored on any other request.
+const MCP_EVAL_RERANK_HEADER = 'x-ganju-eval-rerank';
 const MCP_CHANNEL_ID_HEADER = 'x-ganju-channel-id';
 const MCP_CHANNEL_PLATFORM_HEADER = 'x-ganju-channel-platform';
+// The conversation a channel turn belongs to. The MCP worker files that turn's
+// calls under one session per conversation, so a call can be traced back to
+// the chat it ran in.
+const MCP_CHANNEL_CONVERSATION_HEADER = 'x-ganju-channel-conversation-id';
 const MCP_CHANNEL_CLIENT_USER_AGENT = 'ganju-channel/0.0.1';
 const JWKS_KV_KEY = 'jwks:v1';
 const JWKS_TTL_SECONDS = 600;
@@ -1604,6 +1682,22 @@ const ACCESS_TOKEN_SCOPE_MESSAGE = 'This token is scoped to a different project'
 // Recent custom-tool invocations, as `ganju logs` reads them.
 const CUSTOM_CODE_LOGS_DEFAULT_LIMIT = 20;
 const CUSTOM_CODE_LOGS_MAX_LIMIT = 100;
+// Tool observability on the project home. The windows match the activity
+// chart's, and none reaches past `RETENTION_DAYS.mcpRequest`.
+const OBSERVABILITY_RANGE_DAYS = [7, 30, 90];
+// An enabled tool with no call in this many days is offered for disabling.
+const OBSERVABILITY_UNUSED_DAYS = 30;
+// Two calls in one session this close together are one attempt followed by
+// the next: a retry when it's the same tool, a switch when it's another tool
+// after an error.
+const OBSERVABILITY_FOLLOW_UP_SECONDS = 120;
+// How a call rejected by its tool's input schema reads in `error_message`.
+const OBSERVABILITY_SCHEMA_REJECTION_PREFIX = 'Input validation error';
+const OBSERVABILITY_TOP_ERRORS = 8;
+const OBSERVABILITY_CALLS_DEFAULT_LIMIT = 25;
+const OBSERVABILITY_CALLS_MAX_LIMIT = 100;
+// A session timeline is read whole up to this many calls, newest kept.
+const OBSERVABILITY_SESSION_MAX_CALLS = 500;
 const BOT_GRANT_TYPE = 'urn:ganju:bot-on-behalf-of';
 const EXTERNAL_LINK_VERIFICATION_PREFIX = 'external_link:';
 const EXTERNAL_LINK_TTL_SECONDS = 600;
@@ -1764,6 +1858,39 @@ const PRICING_TOOL_CALL_PER_M_USD = 5;
 // million calls a month, so a fixed ceiling there would fight a real customer.
 const PRICING_TOOL_CALL_HARD_CAP = 20_000_000;
 const PRICING_CUSTOM_DOMAIN_USD = 15;
+// Project data (one SQLite Durable Object per artifact). Cloudflare caps a
+// database at 10 GB; we stop writes that add data at 9 GB so there is room to
+// delete, archive and export.
+const DATA_MAX_DATABASE_BYTES = 9 * GB;
+const DATA_MAX_TABLES_PER_DATABASE = 50;
+const DATA_TRIGGER_RUN_HARD_CAP = 5_000_000;
+// A deleted database can be restored for this long before its storage is
+// freed.
+const DATA_DELETE_GRACE_DAYS = 7;
+const ARTIFACT_DATABASE_STATUS_CREATING = 'CREATING';
+const ARTIFACT_DATABASE_STATUS_READY = 'READY';
+const ARTIFACT_DATABASE_STATUS_FAILED = 'FAILED';
+const ARTIFACT_DATABASE_STATUS_DELETING = 'DELETING';
+// The hourly purge has claimed the row and is emptying the object; a restore
+// can no longer take it back.
+const ARTIFACT_DATABASE_STATUS_PURGING = 'PURGING';
+const ARTIFACT_DATABASE_STATUS_DELETED = 'DELETED';
+const ARTIFACT_DATABASE_STATUSES = [
+    ARTIFACT_DATABASE_STATUS_CREATING,
+    ARTIFACT_DATABASE_STATUS_READY,
+    ARTIFACT_DATABASE_STATUS_FAILED,
+    ARTIFACT_DATABASE_STATUS_DELETING,
+    ARTIFACT_DATABASE_STATUS_PURGING,
+    ARTIFACT_DATABASE_STATUS_DELETED
+];
+// A purge that claimed a row and never finished (the Worker died) is picked
+// up again after this long.
+const DATA_PURGE_STALE_MS = 60 * 60 * 1000;
+// Rows purged per hourly run: each is a call to its database object.
+const DATA_PURGE_BATCH = 20;
+// last_read_at / last_write_at move at most this often, so they aren't a
+// Postgres write per query.
+const DATA_ACTIVITY_THROTTLE_MS = 60 * 60 * 1000;
 const PLAN_LIMITS = {
     FREE: {
         maxProjects: 1,
@@ -1799,7 +1926,11 @@ const PLAN_LIMITS = {
         toolCallHardCap: 10_000,
         includedMessages: 100,
         includedEmbeddedBytes: 5 * MB,
-        autoSyncIntervals: []
+        autoSyncIntervals: [],
+        canUseData: false,
+        maxDataBytes: null,
+        maxDataTablesPerDatabase: null,
+        triggerRunHardCap: 0
     },
     PRO: {
         maxProjects: null,
@@ -1826,7 +1957,11 @@ const PLAN_LIMITS = {
         autoSyncIntervals: [
             RESOURCE_SYNC_INTERVAL_DAILY,
             RESOURCE_SYNC_INTERVAL_WEEKLY
-        ]
+        ],
+        canUseData: true,
+        maxDataBytes: DATA_MAX_DATABASE_BYTES,
+        maxDataTablesPerDatabase: DATA_MAX_TABLES_PER_DATABASE,
+        triggerRunHardCap: DATA_TRIGGER_RUN_HARD_CAP
     },
     ENTERPRISE: {
         maxProjects: null,
@@ -1853,7 +1988,11 @@ const PLAN_LIMITS = {
         autoSyncIntervals: [
             RESOURCE_SYNC_INTERVAL_DAILY,
             RESOURCE_SYNC_INTERVAL_WEEKLY
-        ]
+        ],
+        canUseData: true,
+        maxDataBytes: DATA_MAX_DATABASE_BYTES,
+        maxDataTablesPerDatabase: DATA_MAX_TABLES_PER_DATABASE,
+        triggerRunHardCap: null
     }
 };
 // Quota features — used as the `feature` discriminator on PlanLimitError so the
@@ -1872,6 +2011,7 @@ const PLAN_FEATURE_EMBEDDED_STORAGE = 'embeddedStorage';
 const PLAN_FEATURE_MESSAGE = 'message';
 const PLAN_FEATURE_TOOL_CALL = 'toolCall';
 const PLAN_FEATURE_RESOURCE_SYNC = 'resourceSync';
+const PLAN_FEATURE_DATA = 'data';
 // Stable code returned on a quota block so clients can branch on it (402).
 const PLAN_LIMIT_ERROR_CODE = 'PLAN_LIMIT_EXCEEDED';
 // Billing meter event names. The metering cron reports per-period OVERAGE
@@ -2026,6 +2166,20 @@ exports.constants = {
     PRICING_TOOL_CALL_PER_M_USD,
     PRICING_TOOL_CALL_HARD_CAP,
     PRICING_CUSTOM_DOMAIN_USD,
+    DATA_MAX_DATABASE_BYTES,
+    DATA_MAX_TABLES_PER_DATABASE,
+    DATA_TRIGGER_RUN_HARD_CAP,
+    DATA_DELETE_GRACE_DAYS,
+    DATA_PURGE_BATCH,
+    DATA_ACTIVITY_THROTTLE_MS,
+    ARTIFACT_DATABASE_STATUS_CREATING,
+    ARTIFACT_DATABASE_STATUS_READY,
+    ARTIFACT_DATABASE_STATUS_FAILED,
+    ARTIFACT_DATABASE_STATUS_DELETING,
+    ARTIFACT_DATABASE_STATUS_PURGING,
+    ARTIFACT_DATABASE_STATUS_DELETED,
+    DATA_PURGE_STALE_MS,
+    ARTIFACT_DATABASE_STATUSES,
     PLAN_FEATURE_ORGANIZATION,
     PLAN_FEATURE_PROJECT,
     PLAN_FEATURE_TOOL,
@@ -2040,6 +2194,7 @@ exports.constants = {
     PLAN_FEATURE_MESSAGE,
     PLAN_FEATURE_TOOL_CALL,
     PLAN_FEATURE_RESOURCE_SYNC,
+    PLAN_FEATURE_DATA,
     PLAN_LIMIT_ERROR_CODE,
     BILLING_METER_MESSAGES,
     BILLING_METER_SHARED_MESSAGES,
@@ -2128,6 +2283,7 @@ exports.constants = {
     SLACK_OAUTH_TOKEN_URL,
     OAUTH_TOKEN_URLS,
     CREDENTIAL_REFRESH_BUFFER_MS,
+    CREDENTIAL_REFRESH_GIVE_UP_MS,
     GOOGLE_CALENDAR_API_BASE,
     GOOGLE_DRIVE_API_BASE,
     GOOGLE_DRIVE_DEFAULT_PAGE_SIZE,
@@ -2163,6 +2319,7 @@ exports.constants = {
     ONE_DRIVE_TAB_LABEL_DRIVES,
     ONE_DRIVE_TAB_LABELS,
     REAUTH_ERROR_CODES,
+    OAUTH_CLIENT_ERROR_CODES,
     RESOURCE_TYPE_TOOLTIP_MIN_WIDTH,
     SEARCH_DEBOUNCE_MS,
     GOOGLE_DRIVE_EXPORT_MIME_TYPES,
@@ -2251,6 +2408,7 @@ exports.constants = {
     CRAWL_DEFAULT_MAX_DEPTH,
     CRAWL_MAX_DEPTH_LIMIT,
     CRAWL_PAGE_FETCH_TIMEOUT_MS,
+    CRAWL_MAX_REDIRECTS,
     CRAWL_PAGE_QUEUE_BATCH_SIZE,
     CRAWL_USER_AGENT,
     RESOURCE_ICON_THEME_DARK,
@@ -2268,6 +2426,7 @@ exports.constants = {
     TELEGRAM_MAX_FILE_BYTES,
     RATE_LIMIT_BACKOFF_SECONDS,
     TRANSIENT_BACKOFF_SECONDS,
+    QUEUE_MAX_RETRIES,
     ENCODINGS,
     ENCODING_UTF8,
     CHANNEL_PLATFORM_TELEGRAM,
@@ -2309,6 +2468,16 @@ exports.constants = {
     MCP_TOOL_CONFIRMATION_TTL_MS,
     MCP_TOOL_CONFIRMATION_ARG,
     MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION,
+    MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION_CONDITIONAL,
+    TOOL_APPROVAL_PATH,
+    TOOL_APPROVAL_DECISION_APPROVE,
+    TOOL_APPROVAL_DECISION_DENY,
+    TOOL_APPROVAL_DECISIONS,
+    TOOL_APPROVAL_STATUS_PENDING,
+    TOOL_APPROVAL_STATUS_APPROVED,
+    TOOL_APPROVAL_STATUS_DENIED,
+    TOOL_APPROVAL_STATUS_USED,
+    TOOL_APPROVAL_STATUS_EXPIRED,
     CHANNEL_DEBOUNCE_DEFAULT_MS,
     CHANNEL_DEBOUNCE_MIN_MS,
     CHANNEL_DEBOUNCE_MAX_MS,
@@ -2379,8 +2548,12 @@ exports.constants = {
     RESOURCE_SEARCH_RRF_K,
     RESOURCE_SEARCH_COMMON_TERM_DIVISOR,
     RESOURCE_SEARCH_COMMON_TERM_MIN,
+    RESOURCE_SEARCH_RERANK_ENABLED,
     RESOURCE_SEARCH_RERANK_CANDIDATES,
     RESOURCE_SEARCH_RERANK_MODEL,
+    RESOURCE_SEARCH_EXACT_MAX_RESOURCES,
+    RESOURCE_SEARCH_EXACT_MAX_CHUNKS,
+    RESOURCE_SEARCH_SUBSTRING_MAX_CHUNKS,
     RESOURCE_HANDLER_SLEEP_AFTER,
     DOCS_URL,
     BASE64_DATA_URI_RE,
@@ -2388,6 +2561,8 @@ exports.constants = {
     CHUNK_SEPARATORS,
     DEFAULT_MAX_TOKENS,
     RESOURCE_TOOL_KEY_LIST_RESOURCES,
+    LIST_RESOURCES_DEFAULT_LIMIT,
+    LIST_RESOURCES_MAX_LIMIT,
     RESOURCE_TOOL_KEY_SEARCH_RESOURCES,
     RESOURCE_TOOL_KEY_READ_RESOURCE,
     RESOURCE_TOOL_KEY_SEND_RESOURCE,
@@ -2559,8 +2734,10 @@ exports.constants = {
     CUSTOM_CODE_RESOURCE_FILE_TOO_LARGE_MESSAGE,
     RESERVED_SLUGS,
     MCP_INTERNAL_HEADER,
+    MCP_EVAL_RERANK_HEADER,
     MCP_CHANNEL_ID_HEADER,
     MCP_CHANNEL_PLATFORM_HEADER,
+    MCP_CHANNEL_CONVERSATION_HEADER,
     MCP_CHANNEL_CLIENT_USER_AGENT,
     MCP_SESSION_HEADER,
     MCP_REQUEST_METHOD_INITIALIZE,
@@ -2598,6 +2775,14 @@ exports.constants = {
     ACCESS_TOKEN_SCOPE_MESSAGE,
     CUSTOM_CODE_LOGS_DEFAULT_LIMIT,
     CUSTOM_CODE_LOGS_MAX_LIMIT,
+    OBSERVABILITY_RANGE_DAYS,
+    OBSERVABILITY_UNUSED_DAYS,
+    OBSERVABILITY_FOLLOW_UP_SECONDS,
+    OBSERVABILITY_SCHEMA_REJECTION_PREFIX,
+    OBSERVABILITY_TOP_ERRORS,
+    OBSERVABILITY_CALLS_DEFAULT_LIMIT,
+    OBSERVABILITY_CALLS_MAX_LIMIT,
+    OBSERVABILITY_SESSION_MAX_CALLS,
     BOT_GRANT_TYPE,
     EXTERNAL_LINK_VERIFICATION_PREFIX,
     EXTERNAL_LINK_TTL_SECONDS,

package/dist/data.d.ts

@@ -0,0 +1,9 @@
+export * from './dataTypes';
+export { DATA_IDENTIFIER_PATTERN, DATA_SYSTEM_COLUMNS, DATA_HIDDEN_COLUMNS, identifierIssue, isValidIdentifier } from './dataIdentifiers';
+export { createTableSql, columnDefinitionSql, desiredIndexes, desiredTriggers, ftsCreateSql, ftsTableName, searchableColumns, sqlLiteral } from './dataDdl';
+export { chunkRows, rowsPerInsert, ftsMatch, keysetCondition, encodeCursor, decodeCursor, isSensitiveWrite, tidyArgs, zoned } from './dataCompiler';
+export type { SqlValue, KeysetCursor, SortKey } from './dataCompiler';
+export { INTERNAL_MIGRATIONS, INTERNAL_SCHEMA_VERSION, hasInternalTables, getMeta, setMeta, migrateInternal, loadSchema, toTableInput, normaliseColumn, translateSqliteError, describe, query, write, rowHistory, pruneHistory, deleteImpact, createTable, updateTable, dropTable, addColumn, updateColumn, dropColumn, columnChangeNeedsRebuild, dropColumnNeedsRebuild, readTableCopy, clearFailedTableCopy, copyTableStep, writeReachesCopy, assertActor, assertWritable, exportRows } from './dataEngine';
+export type { SqlRow, SqlRunner } from './dataEngine';
+export type { ProjectDatabaseRpc, DatabaseInfo, ExportFile, ExportFormat, ExportState, RestoreResult } from './dataRpc';
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,SAAS,EACT,aAAa,EACb,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,KAAK,EACN,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,OAAO,EACP,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,KAAK,EACL,KAAK,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,WAAW,CAAC"}

package/dist/data.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeReachesCopy = exports.copyTableStep = exports.clearFailedTableCopy = exports.readTableCopy = exports.dropColumnNeedsRebuild = exports.columnChangeNeedsRebuild = exports.dropColumn = exports.updateColumn = exports.addColumn = exports.dropTable = exports.updateTable = exports.createTable = exports.deleteImpact = exports.pruneHistory = exports.rowHistory = exports.write = exports.query = exports.describe = exports.translateSqliteError = exports.normaliseColumn = exports.toTableInput = exports.loadSchema = exports.migrateInternal = exports.setMeta = exports.getMeta = exports.hasInternalTables = exports.INTERNAL_SCHEMA_VERSION = exports.INTERNAL_MIGRATIONS = exports.zoned = exports.tidyArgs = exports.isSensitiveWrite = exports.decodeCursor = exports.encodeCursor = exports.keysetCondition = exports.ftsMatch = exports.rowsPerInsert = exports.chunkRows = exports.sqlLiteral = exports.searchableColumns = exports.ftsTableName = exports.ftsCreateSql = exports.desiredTriggers = exports.desiredIndexes = exports.columnDefinitionSql = exports.createTableSql = exports.isValidIdentifier = exports.identifierIssue = exports.DATA_HIDDEN_COLUMNS = exports.DATA_SYSTEM_COLUMNS = exports.DATA_IDENTIFIER_PATTERN = void 0;
+exports.exportRows = exports.assertWritable = exports.assertActor = void 0;
+// Entry point for `@ganju/utils/data`: everything a project's database and
+// its callers share, without pulling in the rest of the package.
+__exportStar(require("./dataTypes"), exports);
+var dataIdentifiers_1 = require("./dataIdentifiers");
+Object.defineProperty(exports, "DATA_IDENTIFIER_PATTERN", { enumerable: true, get: function () { return dataIdentifiers_1.DATA_IDENTIFIER_PATTERN; } });
+Object.defineProperty(exports, "DATA_SYSTEM_COLUMNS", { enumerable: true, get: function () { return dataIdentifiers_1.DATA_SYSTEM_COLUMNS; } });
+Object.defineProperty(exports, "DATA_HIDDEN_COLUMNS", { enumerable: true, get: function () { return dataIdentifiers_1.DATA_HIDDEN_COLUMNS; } });
+Object.defineProperty(exports, "identifierIssue", { enumerable: true, get: function () { return dataIdentifiers_1.identifierIssue; } });
+Object.defineProperty(exports, "isValidIdentifier", { enumerable: true, get: function () { return dataIdentifiers_1.isValidIdentifier; } });
+var dataDdl_1 = require("./dataDdl");
+Object.defineProperty(exports, "createTableSql", { enumerable: true, get: function () { return dataDdl_1.createTableSql; } });
+Object.defineProperty(exports, "columnDefinitionSql", { enumerable: true, get: function () { return dataDdl_1.columnDefinitionSql; } });
+Object.defineProperty(exports, "desiredIndexes", { enumerable: true, get: function () { return dataDdl_1.desiredIndexes; } });
+Object.defineProperty(exports, "desiredTriggers", { enumerable: true, get: function () { return dataDdl_1.desiredTriggers; } });
+Object.defineProperty(exports, "ftsCreateSql", { enumerable: true, get: function () { return dataDdl_1.ftsCreateSql; } });
+Object.defineProperty(exports, "ftsTableName", { enumerable: true, get: function () { return dataDdl_1.ftsTableName; } });
+Object.defineProperty(exports, "searchableColumns", { enumerable: true, get: function () { return dataDdl_1.searchableColumns; } });
+Object.defineProperty(exports, "sqlLiteral", { enumerable: true, get: function () { return dataDdl_1.sqlLiteral; } });
+var dataCompiler_1 = require("./dataCompiler");
+Object.defineProperty(exports, "chunkRows", { enumerable: true, get: function () { return dataCompiler_1.chunkRows; } });
+Object.defineProperty(exports, "rowsPerInsert", { enumerable: true, get: function () { return dataCompiler_1.rowsPerInsert; } });
+Object.defineProperty(exports, "ftsMatch", { enumerable: true, get: function () { return dataCompiler_1.ftsMatch; } });
+Object.defineProperty(exports, "keysetCondition", { enumerable: true, get: function () { return dataCompiler_1.keysetCondition; } });
+Object.defineProperty(exports, "encodeCursor", { enumerable: true, get: function () { return dataCompiler_1.encodeCursor; } });
+Object.defineProperty(exports, "decodeCursor", { enumerable: true, get: function () { return dataCompiler_1.decodeCursor; } });
+Object.defineProperty(exports, "isSensitiveWrite", { enumerable: true, get: function () { return dataCompiler_1.isSensitiveWrite; } });
+Object.defineProperty(exports, "tidyArgs", { enumerable: true, get: function () { return dataCompiler_1.tidyArgs; } });
+Object.defineProperty(exports, "zoned", { enumerable: true, get: function () { return dataCompiler_1.zoned; } });
+var dataEngine_1 = require("./dataEngine");
+Object.defineProperty(exports, "INTERNAL_MIGRATIONS", { enumerable: true, get: function () { return dataEngine_1.INTERNAL_MIGRATIONS; } });
+Object.defineProperty(exports, "INTERNAL_SCHEMA_VERSION", { enumerable: true, get: function () { return dataEngine_1.INTERNAL_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "hasInternalTables", { enumerable: true, get: function () { return dataEngine_1.hasInternalTables; } });
+Object.defineProperty(exports, "getMeta", { enumerable: true, get: function () { return dataEngine_1.getMeta; } });
+Object.defineProperty(exports, "setMeta", { enumerable: true, get: function () { return dataEngine_1.setMeta; } });
+Object.defineProperty(exports, "migrateInternal", { enumerable: true, get: function () { return dataEngine_1.migrateInternal; } });
+Object.defineProperty(exports, "loadSchema", { enumerable: true, get: function () { return dataEngine_1.loadSchema; } });
+Object.defineProperty(exports, "toTableInput", { enumerable: true, get: function () { return dataEngine_1.toTableInput; } });
+Object.defineProperty(exports, "normaliseColumn", { enumerable: true, get: function () { return dataEngine_1.normaliseColumn; } });
+Object.defineProperty(exports, "translateSqliteError", { enumerable: true, get: function () { return dataEngine_1.translateSqliteError; } });
+Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return dataEngine_1.describe; } });
+Object.defineProperty(exports, "query", { enumerable: true, get: function () { return dataEngine_1.query; } });
+Object.defineProperty(exports, "write", { enumerable: true, get: function () { return dataEngine_1.write; } });
+Object.defineProperty(exports, "rowHistory", { enumerable: true, get: function () { return dataEngine_1.rowHistory; } });
+Object.defineProperty(exports, "pruneHistory", { enumerable: true, get: function () { return dataEngine_1.pruneHistory; } });
+Object.defineProperty(exports, "deleteImpact", { enumerable: true, get: function () { return dataEngine_1.deleteImpact; } });
+Object.defineProperty(exports, "createTable", { enumerable: true, get: function () { return dataEngine_1.createTable; } });
+Object.defineProperty(exports, "updateTable", { enumerable: true, get: function () { return dataEngine_1.updateTable; } });
+Object.defineProperty(exports, "dropTable", { enumerable: true, get: function () { return dataEngine_1.dropTable; } });
+Object.defineProperty(exports, "addColumn", { enumerable: true, get: function () { return dataEngine_1.addColumn; } });
+Object.defineProperty(exports, "updateColumn", { enumerable: true, get: function () { return dataEngine_1.updateColumn; } });
+Object.defineProperty(exports, "dropColumn", { enumerable: true, get: function () { return dataEngine_1.dropColumn; } });
+Object.defineProperty(exports, "columnChangeNeedsRebuild", { enumerable: true, get: function () { return dataEngine_1.columnChangeNeedsRebuild; } });
+Object.defineProperty(exports, "dropColumnNeedsRebuild", { enumerable: true, get: function () { return dataEngine_1.dropColumnNeedsRebuild; } });
+Object.defineProperty(exports, "readTableCopy", { enumerable: true, get: function () { return dataEngine_1.readTableCopy; } });
+Object.defineProperty(exports, "clearFailedTableCopy", { enumerable: true, get: function () { return dataEngine_1.clearFailedTableCopy; } });
+Object.defineProperty(exports, "copyTableStep", { enumerable: true, get: function () { return dataEngine_1.copyTableStep; } });
+Object.defineProperty(exports, "writeReachesCopy", { enumerable: true, get: function () { return dataEngine_1.writeReachesCopy; } });
+Object.defineProperty(exports, "assertActor", { enumerable: true, get: function () { return dataEngine_1.assertActor; } });
+Object.defineProperty(exports, "assertWritable", { enumerable: true, get: function () { return dataEngine_1.assertWritable; } });
+Object.defineProperty(exports, "exportRows", { enumerable: true, get: function () { return dataEngine_1.exportRows; } });