@collage-dam/mcp-server 0.1.0

package/dist/conventions/errors.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/**
+ * Canonical error codes for all MCP tool responses.
+ */
+const ERROR_CODES = [
+    'UNAUTHORIZED',
+    'FORBIDDEN',
+    'NOT_FOUND',
+    'VALIDATION',
+    'RATE_LIMITED',
+    'UPSTREAM',
+    'CONFIRMATION_STALE',
+    'CONFIRMATION_MISSING',
+    'CONFIRMATION_STATE_DIVERGED',
+    'ENTITLEMENT',
+    'INTERNAL',
+];
+/**
+ * Error codes that are retriable by default.
+ */
+const RETRIABLE_CODES = new Set([
+    'RATE_LIMITED',
+    'UPSTREAM',
+    'INTERNAL',
+]);
+export const ErrorCodeSchema = z.enum(ERROR_CODES);
+export const McpToolErrorCauseSchema = z
+    .object({
+    upstream_status: z.number().int().optional(),
+    request_id: z.string().optional(),
+})
+    .passthrough();
+export const McpToolErrorSchema = z.object({
+    code: ErrorCodeSchema,
+    message: z.string(),
+    retriable: z.boolean(),
+    cause: McpToolErrorCauseSchema.optional(),
+});
+/**
+ * Returns whether the given error code is retriable by default.
+ */
+export function isRetriable(code) {
+    return RETRIABLE_CODES.has(code);
+}
+/**
+ * Create a validated McpToolError.
+ * If `retriable` is not provided, it defaults based on the error code.
+ */
+export function createToolError(code, message, opts) {
+    const error = {
+        code,
+        message,
+        retriable: opts?.retriable ?? isRetriable(code),
+        ...(opts?.cause !== undefined ? { cause: opts.cause } : {}),
+    };
+    return McpToolErrorSchema.parse(error);
+}
+/**
+ * Map an HTTP status code to the corresponding McpToolError code.
+ */
+export function mapHttpStatusToErrorCode(status) {
+    switch (status) {
+        case 401:
+            return 'UNAUTHORIZED';
+        case 403:
+            return 'FORBIDDEN';
+        case 404:
+            return 'NOT_FOUND';
+        case 422:
+            return 'VALIDATION';
+        case 429:
+            return 'RATE_LIMITED';
+        default: {
+            if (status >= 500 && status < 600) {
+                return 'UPSTREAM';
+            }
+            return 'INTERNAL';
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/conventions/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/conventions/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,cAAc;IACd,WAAW;IACX,WAAW;IACX,YAAY;IACZ,cAAc;IACd,UAAU;IACV,oBAAoB;IACpB,sBAAsB;IACtB,6BAA6B;IAC7B,aAAa;IACb,UAAU;CACF,CAAC;AAEX;;GAEG;AACH,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC;IACtD,cAAc;IACd,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAGnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,KAAK,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAe,EACf,OAAe,EACf,IAA0B;IAE1B,MAAM,KAAK,GAAiB;QAC1B,IAAI;QACJ,OAAO;QACP,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC;QAC/C,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;IACF,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,cAAc,CAAC;QACxB,KAAK,GAAG;YACN,OAAO,WAAW,CAAC;QACrB,KAAK,GAAG;YACN,OAAO,WAAW,CAAC;QACrB,KAAK,GAAG;YACN,OAAO,YAAY,CAAC;QACtB,KAAK,GAAG;YACN,OAAO,cAAc,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;gBAClC,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/conventions/logger.d.ts

@@ -0,0 +1,28 @@
+import pino from 'pino';
+/**
+ * Create a pino logger configured per project conventions:
+ * - JSON output written to **stderr** (stdout is reserved for MCP stdio framing)
+ * - ISO timestamp in `ts` field
+ * - Redaction of credential-bearing paths
+ * - Level from LOG_LEVEL env var (default: info)
+ */
+export declare function createLogger(): pino.Logger;
+/**
+ * Generate a ULID suitable for use as a request identifier.
+ */
+export declare function generateRequestId(): string;
+/**
+ * Create a child logger bound with tool context and a fresh request_id.
+ */
+export declare function createToolLogger(parentLogger: pino.Logger, toolName: string, workspaceId: string): pino.Logger;
+/**
+ * Strip sensitive field values from an object before it is logged.
+ *
+ * Keys matching common filename / metadata patterns are replaced
+ * with `[REDACTED]`. Nested objects are processed recursively.
+ * The original object is not mutated; a shallow-ish copy is returned.
+ */
+export declare function redactSensitiveFields(obj: Record<string, unknown>): Record<string, unknown>;
+/** Singleton logger instance created once on import. */
+export declare const logger: pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/conventions/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/conventions/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAiCxB;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAAC,MAAM,CA4B1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,IAAI,CAAC,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,MAAM,CAMb;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAMD,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,IAAI,CAAC,MAAuB,CAAC"}

package/dist/conventions/logger.js

@@ -0,0 +1,105 @@
+import pino from 'pino';
+import { ulid } from 'ulid';
+/**
+ * Keys whose values should be replaced with [REDACTED] when logging
+ * request/response bodies to avoid leaking filenames and metadata.
+ */
+const SENSITIVE_BODY_KEYS = new Set([
+    'file_name',
+    'display_file_name',
+    'filename',
+    'description',
+    'custom_fields',
+    'metadata',
+]);
+const VALID_LEVELS = new Set([
+    'debug',
+    'info',
+    'warn',
+    'error',
+]);
+function resolveLogLevel() {
+    const env = process.env['LOG_LEVEL'];
+    if (env && VALID_LEVELS.has(env)) {
+        return env;
+    }
+    return 'info';
+}
+/**
+ * Create a pino logger configured per project conventions:
+ * - JSON output written to **stderr** (stdout is reserved for MCP stdio framing)
+ * - ISO timestamp in `ts` field
+ * - Redaction of credential-bearing paths
+ * - Level from LOG_LEVEL env var (default: info)
+ */
+export function createLogger() {
+    return pino({
+        level: resolveLogLevel(),
+        timestamp: () => `,"ts":"${new Date().toISOString()}"`,
+        redact: {
+            paths: [
+                '*.api_key',
+                '*.apiKey',
+                '*.token',
+                '*.signed_token',
+                '*.confirmation_token',
+                '*.password',
+                '*.secret',
+                '*.authorization',
+                '*.Authorization',
+                '*.bearer',
+                '*.COLLAGE_API_KEY',
+                '*.TYPESENSE_API_KEY',
+                '*.MCP_CONFIRMATION_SECRET',
+            ],
+            censor: '[REDACTED]',
+        },
+    }, 
+    // fd 2 = stderr. Required for stdio transport — anything on stdout
+    // corrupts JSON-RPC framing and the MCP client will disconnect.
+    pino.destination({ fd: 2, sync: false }));
+}
+/**
+ * Generate a ULID suitable for use as a request identifier.
+ */
+export function generateRequestId() {
+    return ulid();
+}
+/**
+ * Create a child logger bound with tool context and a fresh request_id.
+ */
+export function createToolLogger(parentLogger, toolName, workspaceId) {
+    return parentLogger.child({
+        tool: toolName,
+        workspace_id: workspaceId,
+        request_id: generateRequestId(),
+    });
+}
+/**
+ * Strip sensitive field values from an object before it is logged.
+ *
+ * Keys matching common filename / metadata patterns are replaced
+ * with `[REDACTED]`. Nested objects are processed recursively.
+ * The original object is not mutated; a shallow-ish copy is returned.
+ */
+export function redactSensitiveFields(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (SENSITIVE_BODY_KEYS.has(key)) {
+            result[key] = '[REDACTED]';
+        }
+        else if (isRecord(value)) {
+            result[key] = redactSensitiveFields(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Singleton logger instance created once on import. */
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/conventions/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/conventions/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,WAAW;IACX,mBAAmB;IACnB,UAAU;IACV,aAAa;IACb,eAAe;IACf,UAAU;CACX,CAAC,CAAC;AAIH,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAS;IACxD,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,GAAe,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CACT;QACE,KAAK,EAAE,eAAe,EAAE;QACxB,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG;QACtD,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,WAAW;gBACX,UAAU;gBACV,SAAS;gBACT,gBAAgB;gBAChB,sBAAsB;gBACtB,YAAY;gBACZ,UAAU;gBACV,iBAAiB;gBACjB,iBAAiB;gBACjB,UAAU;gBACV,mBAAmB;gBACnB,qBAAqB;gBACrB,2BAA2B;aAC5B;YACD,MAAM,EAAE,YAAY;SACrB;KACF;IACD,mEAAmE;IACnE,gEAAgE;IAChE,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CACzC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAyB,EACzB,QAAgB,EAChB,WAAmB;IAEnB,OAAO,YAAY,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,iBAAiB,EAAE;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAA4B;IAE5B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,MAAM,GAAgB,YAAY,EAAE,CAAC"}

package/dist/conventions/pagination.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export declare const DEFAULT_PAGE_SIZE = 50;
+export declare const MAX_PAGE_SIZE = 500;
+export declare const PaginationParamsSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    page_size: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page_size: number;
+    cursor?: string | undefined;
+}, {
+    cursor?: string | undefined;
+    page_size?: number | undefined;
+}>;
+export type PaginationParams = z.infer<typeof PaginationParamsSchema>;
+export declare function paginatedResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    items: z.ZodArray<T, "many">;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    total_estimate: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    items: T["_output"][];
+    next_cursor: string | null;
+    total_estimate: number | null;
+}, {
+    items: T["_input"][];
+    next_cursor: string | null;
+    total_estimate: number | null;
+}>;
+export type PaginatedResponse<T> = {
+    items: T[];
+    next_cursor: string | null;
+    total_estimate: number | null;
+};
+export declare function encodeCursor(offset: number): string;
+export declare function decodeCursor(cursor: string): number;
+export declare function clampPageSize(requested: number | undefined): number;
+export declare function buildPaginatedResponse<T>(items: T[], offset: number, pageSize: number, totalEstimate: number | null): PaginatedResponse<T>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/conventions/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/conventions/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAC;AAGjC,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;;;;;;;;;;;;GAM5E;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWnD;AAGD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKnE;AAGD,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,iBAAiB,CAAC,CAAC,CAAC,CAWtB"}

package/dist/conventions/pagination.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+// ── Constants ──────────────────────────────────────────────────────────
+export const DEFAULT_PAGE_SIZE = 50;
+export const MAX_PAGE_SIZE = 500;
+// ── Input schema ───────────────────────────────────────────────────────
+export const PaginationParamsSchema = z.object({
+    cursor: z.string().optional(),
+    page_size: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE),
+});
+// ── Response schema factory ────────────────────────────────────────────
+export function paginatedResponseSchema(itemSchema) {
+    return z.object({
+        items: z.array(itemSchema),
+        next_cursor: z.string().nullable(),
+        total_estimate: z.number().nullable(),
+    });
+}
+// ── Cursor helpers ─────────────────────────────────────────────────────
+export function encodeCursor(offset) {
+    return Buffer.from(String(offset), "utf-8").toString("base64");
+}
+export function decodeCursor(cursor) {
+    try {
+        const decoded = Buffer.from(cursor, "base64").toString("utf-8");
+        const parsed = Number(decoded);
+        if (!Number.isFinite(parsed) || parsed < 0 || !Number.isInteger(parsed)) {
+            return 0;
+        }
+        return parsed;
+    }
+    catch {
+        return 0;
+    }
+}
+// ── Page-size clamping ─────────────────────────────────────────────────
+export function clampPageSize(requested) {
+    if (requested === undefined) {
+        return DEFAULT_PAGE_SIZE;
+    }
+    return Math.max(1, Math.min(requested, MAX_PAGE_SIZE));
+}
+// ── Response builder ───────────────────────────────────────────────────
+export function buildPaginatedResponse(items, offset, pageSize, totalEstimate) {
+    const hasMore = totalEstimate !== null
+        ? offset + pageSize < totalEstimate
+        : items.length === pageSize;
+    return {
+        items,
+        next_cursor: hasMore ? encodeCursor(offset + pageSize) : null,
+        total_estimate: totalEstimate,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/conventions/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/conventions/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;CACjF,CAAC,CAAC;AAIH,0EAA0E;AAC1E,MAAM,UAAU,uBAAuB,CAAyB,UAAa;IAC3E,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC,CAAC;AACL,CAAC;AAQD,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACxE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,SAA6B;IACzD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CACpC,KAAU,EACV,MAAc,EACd,QAAgB,EAChB,aAA4B;IAE5B,MAAM,OAAO,GACX,aAAa,KAAK,IAAI;QACpB,CAAC,CAAC,MAAM,GAAG,QAAQ,GAAG,aAAa;QACnC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;IAEhC,OAAO;QACL,KAAK;QACL,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7D,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC"}

package/dist/conventions/rate-limiter.d.ts

@@ -0,0 +1,54 @@
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+/**
+ * Thrown when an upstream 429 or 5xx is encountered.
+ * Carries an optional `retryAfterMs` so `withRetry` can honour
+ * the server's `Retry-After` header.
+ */
+export declare class RateLimitedError extends Error {
+    readonly retryAfterMs: number | undefined;
+    readonly statusCode: number;
+    constructor(message: string, opts: {
+        statusCode: number;
+        retryAfterMs?: number;
+    });
+}
+/**
+ * A simple sliding-window rate limiter.
+ *
+ * Tracks timestamps of recent requests within a 1-second window.
+ * When the window is full (`maxRps` requests), `acquire()` delays
+ * until the oldest timestamp falls outside the window.
+ */
+export declare class TokenBucketRateLimiter {
+    private readonly maxRps;
+    private readonly timestamps;
+    constructor(opts?: {
+        maxRps?: number;
+    });
+    /**
+     * Wait until a token is available, then record the request.
+     */
+    acquire(): Promise<void>;
+    /**
+     * Clear all tracked timestamps (useful in tests).
+     */
+    reset(): void;
+    /**
+     * Remove timestamps older than 1 second from the window.
+     */
+    private prune;
+}
+/**
+ * Execute `fn`, retrying on retriable errors (429, 5xx) with
+ * exponential backoff and jitter.
+ *
+ * If the error carries a `retryAfterMs` value (from an upstream
+ * `Retry-After` header), that value is used instead of the
+ * computed backoff — unless it exceeds `maxDelayMs`.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/conventions/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/conventions/rate-limiter.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAOtD;AA2CD;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAE/B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAItC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,KAAK;CAMd;AAID;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/dist/conventions/rate-limiter.js

@@ -0,0 +1,143 @@
+// ── Rate Limiter ─────────────────────────────────────────────────────
+// Token-bucket rate limiter and retry logic for the Collage HTTP client.
+// One limiter instance per workspace; no external dependencies.
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 30_000,
+};
+// ── RateLimitedError ──────────────────────────────────────────────────
+/**
+ * Thrown when an upstream 429 or 5xx is encountered.
+ * Carries an optional `retryAfterMs` so `withRetry` can honour
+ * the server's `Retry-After` header.
+ */
+export class RateLimitedError extends Error {
+    retryAfterMs;
+    statusCode;
+    constructor(message, opts) {
+        super(message);
+        this.name = 'RateLimitedError';
+        this.statusCode = opts.statusCode;
+        this.retryAfterMs = opts.retryAfterMs;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function isRetriableStatus(status) {
+    return status === 429 || (status >= 500 && status < 600);
+}
+function isRetriableError(err) {
+    return err instanceof RateLimitedError && isRetriableStatus(err.statusCode);
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Compute jittered exponential backoff delay.
+ * Formula: min(baseDelay * 2^attempt + jitter, maxDelay)
+ * where jitter is a random value in [0, baseDelay).
+ */
+function computeBackoff(attempt, config) {
+    const exponential = config.baseDelayMs * Math.pow(2, attempt);
+    const jitter = Math.random() * config.baseDelayMs;
+    return Math.min(exponential + jitter, config.maxDelayMs);
+}
+// ── TokenBucketRateLimiter ────────────────────────────────────────────
+function getDefaultMaxRps() {
+    const envVal = process.env['COLLAGE_MAX_RPS'];
+    if (envVal !== undefined && envVal !== '') {
+        const parsed = Number(envVal);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return 10;
+}
+/**
+ * A simple sliding-window rate limiter.
+ *
+ * Tracks timestamps of recent requests within a 1-second window.
+ * When the window is full (`maxRps` requests), `acquire()` delays
+ * until the oldest timestamp falls outside the window.
+ */
+export class TokenBucketRateLimiter {
+    maxRps;
+    timestamps = [];
+    constructor(opts) {
+        this.maxRps = opts?.maxRps ?? getDefaultMaxRps();
+    }
+    /**
+     * Wait until a token is available, then record the request.
+     */
+    async acquire() {
+        const now = Date.now();
+        // Prune timestamps older than 1 second
+        this.prune(now);
+        if (this.timestamps.length < this.maxRps) {
+            this.timestamps.push(Date.now());
+            return;
+        }
+        // Window is full — wait until the oldest timestamp expires
+        const oldest = this.timestamps[0];
+        if (oldest !== undefined) {
+            const waitMs = oldest + 1000 - now;
+            if (waitMs > 0) {
+                await delay(waitMs);
+            }
+        }
+        // After waiting, prune again and record
+        this.prune(Date.now());
+        this.timestamps.push(Date.now());
+    }
+    /**
+     * Clear all tracked timestamps (useful in tests).
+     */
+    reset() {
+        this.timestamps.length = 0;
+    }
+    /**
+     * Remove timestamps older than 1 second from the window.
+     */
+    prune(now) {
+        const cutoff = now - 1000;
+        while (this.timestamps.length > 0 && (this.timestamps[0] ?? 0) <= cutoff) {
+            this.timestamps.shift();
+        }
+    }
+}
+// ── withRetry ─────────────────────────────────────────────────────────
+/**
+ * Execute `fn`, retrying on retriable errors (429, 5xx) with
+ * exponential backoff and jitter.
+ *
+ * If the error carries a `retryAfterMs` value (from an upstream
+ * `Retry-After` header), that value is used instead of the
+ * computed backoff — unless it exceeds `maxDelayMs`.
+ */
+export async function withRetry(fn, config) {
+    const resolved = { ...DEFAULT_RETRY_CONFIG, ...config };
+    let lastError;
+    for (let attempt = 0; attempt <= resolved.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            // If it's the last attempt or not retriable, stop retrying.
+            if (attempt >= resolved.maxRetries || !isRetriableError(err)) {
+                break;
+            }
+            // Determine how long to wait.
+            let waitMs;
+            if (err.retryAfterMs !== undefined && err.retryAfterMs > 0) {
+                waitMs = Math.min(err.retryAfterMs, resolved.maxDelayMs);
+            }
+            else {
+                waitMs = computeBackoff(attempt, resolved);
+            }
+            await delay(waitMs);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/conventions/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/conventions/rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/conventions/response-budget.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+/** Soft-warn threshold — log a warning when a single tool response exceeds this. */
+export declare const SOFT_WARN_TOKENS = 4000;
+/** Hard cap — automatically truncate responses that exceed this. */
+export declare const HARD_CAP_TOKENS = 12000;
+/**
+ * Rough token-count heuristic for English text.
+ *
+ * cl100k_base averages ~4 characters per token for typical English /
+ * JSON-serialised content.  This avoids pulling in the full tiktoken
+ * dependency while remaining "good enough" for budget enforcement.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Zod schema factory for a budget-wrapped response.
+ *
+ * Usage:
+ *   const schema = responseBudgetResultSchema(z.array(myItemSchema));
+ */
+export declare function responseBudgetResultSchema<S extends z.ZodTypeAny>(dataSchema: S): z.ZodObject<{
+    data: S;
+    token_estimate: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    data: S;
+    token_estimate: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}>, any> extends infer T ? { [k in keyof T]: T[k]; } : never, z.baseObjectInputType<{
+    data: S;
+    token_estimate: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}> extends infer T_1 ? { [k_1 in keyof T_1]: T_1[k_1]; } : never>;
+/** Generic type derived from the schema. */
+export interface ResponseBudgetResult<T> {
+    data: T;
+    token_estimate: number;
+    truncated: boolean;
+    next_cursor?: string | null;
+}
+export interface ApplyResponseBudgetOpts<T> {
+    /** Serialise a single item to the string that will be measured. */
+    serialize: (item: T) => string;
+    /** Zero-based offset into the original list (for cursor calculation). */
+    offset: number;
+    /** Maximum number of items the caller originally requested. */
+    pageSize: number;
+}
+/**
+ * Walk through `items`, accumulating estimated tokens.  If the running
+ * total would exceed {@link HARD_CAP_TOKENS}, stop early, mark the
+ * response as truncated, and attach a `next_cursor` so the caller can
+ * resume.
+ */
+export declare function applyResponseBudget<T>(items: T[], opts: ApplyResponseBudgetOpts<T>): ResponseBudgetResult<T[]>;
+/**
+ * Log a warning to stderr when a response exceeds {@link SOFT_WARN_TOKENS}.
+ *
+ * This intentionally writes to `process.stderr` so it stays out of MCP
+ * stdout transport.  Will be replaced with pino once the shared logger
+ * convention lands.
+ */
+export declare function warnIfOverBudget(tokenEstimate: number, toolName: string): void;
+//# sourceMappingURL=response-budget.d.ts.map

package/dist/conventions/response-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-budget.d.ts","sourceRoot":"","sources":["../../src/conventions/response-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,oEAAoE;AACpE,eAAO,MAAM,eAAe,QAAS,CAAC;AAMtC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAMD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;;;;;;;;;;;;;;;kEAO/E;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC;IACR,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAMD,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,mEAAmE;IACnE,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAC/B,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAgC3B;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO9E"}