@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/resource-memberships.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resource-memberships.test.d.ts.map

package/dist/resource-memberships.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-memberships.test.d.ts","sourceRoot":"","sources":["../src/resource-memberships.test.ts"],"names":[],"mappings":""}

package/dist/resource-memberships.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { updateDocumentResourceMembershipSchema, updateResourceMembershipSchema, } from "./validators/resource-memberships.js";
+describe("resource membership contract", () => {
+    it("accepts legacy state-only membership updates", () => {
+        expect(updateResourceMembershipSchema.parse({ state: "left" })).toEqual({ state: "left" });
+        expect(updateResourceMembershipSchema.parse({ state: "joined" })).toEqual({ state: "joined" });
+    });
+    it("accepts star-only updates without requiring a state mutation", () => {
+        expect(updateResourceMembershipSchema.parse({ starred: true })).toEqual({ starred: true });
+        expect(updateResourceMembershipSchema.parse({ starred: false })).toEqual({ starred: false });
+    });
+    it("rejects empty or contradictory star/state updates", () => {
+        expect(() => updateResourceMembershipSchema.parse({})).toThrow("state or starred is required");
+        expect(() => updateResourceMembershipSchema.parse({ state: "left", starred: true })).toThrow("starred resources must be joined");
+    });
+    it("accepts document star updates without join state", () => {
+        expect(updateDocumentResourceMembershipSchema.parse({ starred: true })).toEqual({ starred: true });
+        expect(updateDocumentResourceMembershipSchema.parse({ starred: false })).toEqual({ starred: false });
+        expect(() => updateDocumentResourceMembershipSchema.parse({ state: "joined", starred: true })).toThrow();
+        expect(() => updateDocumentResourceMembershipSchema.parse({})).toThrow();
+    });
+});
+//# sourceMappingURL=resource-memberships.test.js.map

package/dist/resource-memberships.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-memberships.test.js","sourceRoot":"","sources":["../src/resource-memberships.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,sCAAsC,EACtC,8BAA8B,GAC/B,MAAM,sCAAsC,CAAC;AAE9C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAC/F,MAAM,CAAC,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAC1F,kCAAkC,CACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,sCAAsC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnG,MAAM,CAAC,sCAAsC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACzG,MAAM,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/responsible-user-denial.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copy contract for responsible-user ("on behalf of") authorization denials.
+ *
+ * When an agent run acts on behalf of a human user, authorization is the
+ * intersection of the agent's permissions and that user's permissions
+ * (see PAP-12447 / PAP-12459). When the intersection denies, the authz layer
+ * emits one of the codes below (`AuthorizationDecision.code` in
+ * `server/src/services/authorization.ts`). This module is the single source of
+ * truth for how those codes are explained to humans, so every surface that
+ * renders an agent-call failure uses consistent, actionable language.
+ *
+ * Terminology is deliberate: always "on behalf of {user}" / "responsible user",
+ * never "impersonate".
+ */
+export declare const RESPONSIBLE_USER_DENIAL_CODES: readonly ["RESPONSIBLE_USER_UNAUTHORIZED", "RESPONSIBLE_USER_UNAVAILABLE"];
+export type ResponsibleUserDenialCode = (typeof RESPONSIBLE_USER_DENIAL_CODES)[number];
+export type ResponsibleUserDenialTone = "unauthorized" | "unavailable";
+export interface ResponsibleUserDenialCopy {
+    code: ResponsibleUserDenialCode;
+    tone: ResponsibleUserDenialTone;
+    /** Short heading, e.g. for a banner title. */
+    title: string;
+    /** One or two sentences explaining what happened and why. */
+    description: string;
+    /** What the reader should do next. */
+    recommendedAction: string;
+}
+export declare function isResponsibleUserDenialCode(code: string | null | undefined): code is ResponsibleUserDenialCode;
+/**
+ * Render a stable label for the responsible user. Falls back to a generic
+ * noun when the display name is unknown, so copy never shows a raw id.
+ */
+export declare function responsibleUserLabel(userName: string | null | undefined): string;
+/**
+ * Describe a responsible-user denial for display. `userName` is the responsible
+ * user's display name when known; when omitted, generic phrasing is used.
+ *
+ * These two codes are distinct from a plain agent-lacks-permission denial: here
+ * the *agent* is allowed but the *human this run acts for* is not (or is no
+ * longer available). Callers should keep the existing generic agent-permission
+ * copy for denials whose code is neither of these.
+ */
+export declare function describeResponsibleUserDenial(code: ResponsibleUserDenialCode, options?: {
+    userName?: string | null;
+}): ResponsibleUserDenialCopy;
+//# sourceMappingURL=responsible-user-denial.d.ts.map

package/dist/responsible-user-denial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsible-user-denial.d.ts","sourceRoot":"","sources":["../src/responsible-user-denial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,6BAA6B,YACxC,+BAA+B,EAC/B,8BAA8B,CACtB,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,aAAa,CAAC;AAEvE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,IAAI,EAAE,yBAAyB,CAAC;IAChC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,IAAI,IAAI,yBAAyB,CAInC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,yBAAyB,EAC/B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACzC,yBAAyB,CAgC3B"}

package/dist/responsible-user-denial.js

@@ -0,0 +1,66 @@
+/**
+ * Copy contract for responsible-user ("on behalf of") authorization denials.
+ *
+ * When an agent run acts on behalf of a human user, authorization is the
+ * intersection of the agent's permissions and that user's permissions
+ * (see PAP-12447 / PAP-12459). When the intersection denies, the authz layer
+ * emits one of the codes below (`AuthorizationDecision.code` in
+ * `server/src/services/authorization.ts`). This module is the single source of
+ * truth for how those codes are explained to humans, so every surface that
+ * renders an agent-call failure uses consistent, actionable language.
+ *
+ * Terminology is deliberate: always "on behalf of {user}" / "responsible user",
+ * never "impersonate".
+ */
+export const RESPONSIBLE_USER_DENIAL_CODES = [
+    "RESPONSIBLE_USER_UNAUTHORIZED",
+    "RESPONSIBLE_USER_UNAVAILABLE",
+];
+export function isResponsibleUserDenialCode(code) {
+    return (code === "RESPONSIBLE_USER_UNAUTHORIZED" || code === "RESPONSIBLE_USER_UNAVAILABLE");
+}
+/**
+ * Render a stable label for the responsible user. Falls back to a generic
+ * noun when the display name is unknown, so copy never shows a raw id.
+ */
+export function responsibleUserLabel(userName) {
+    const trimmed = userName?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed : "the responsible user";
+}
+/**
+ * Describe a responsible-user denial for display. `userName` is the responsible
+ * user's display name when known; when omitted, generic phrasing is used.
+ *
+ * These two codes are distinct from a plain agent-lacks-permission denial: here
+ * the *agent* is allowed but the *human this run acts for* is not (or is no
+ * longer available). Callers should keep the existing generic agent-permission
+ * copy for denials whose code is neither of these.
+ */
+export function describeResponsibleUserDenial(code, options = {}) {
+    const who = responsibleUserLabel(options.userName);
+    if (code === "RESPONSIBLE_USER_UNAVAILABLE") {
+        return {
+            code,
+            tone: "unavailable",
+            title: "Responsible user unavailable",
+            description: `This run acts on behalf of ${who}, but that account was removed or ` +
+                `deactivated, so its permissions can no longer be evaluated. The agent's ` +
+                `own permissions are not enough on their own — every action still requires ` +
+                `an active responsible user.`,
+            recommendedAction: `Mark the work blocked and reassign a responsible user (or reactivate the ` +
+                `account) before the agent continues.`,
+        };
+    }
+    return {
+        code,
+        tone: "unauthorized",
+        title: "Responsible user not authorized",
+        description: `This action was denied because ${who} — the user this run acts on behalf ` +
+            `of — does not have permission to perform it. The agent may be allowed, but ` +
+            `a run can never exceed the permissions of the user it acts for, so the ` +
+            `action is blocked.`,
+        recommendedAction: `Grant ${who} the required permission, or have someone who is authorized ` +
+            `take this action instead.`,
+    };
+}
+//# sourceMappingURL=responsible-user-denial.js.map

package/dist/responsible-user-denial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsible-user-denial.js","sourceRoot":"","sources":["../src/responsible-user-denial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,+BAA+B;IAC/B,8BAA8B;CACtB,CAAC;AAiBX,MAAM,UAAU,2BAA2B,CACzC,IAA+B;IAE/B,OAAO,CACL,IAAI,KAAK,+BAA+B,IAAI,IAAI,KAAK,8BAA8B,CACpF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAmC;IACtE,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;AAC1E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAA+B,EAC/B,OAAO,GAAiC,EAAE;IAE1C,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnD,IAAI,IAAI,KAAK,8BAA8B,EAAE,CAAC;QAC5C,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,8BAA8B,GAAG,oCAAoC;gBACrE,0EAA0E;gBAC1E,4EAA4E;gBAC5E,6BAA6B;YAC/B,iBAAiB,EACf,2EAA2E;gBAC3E,sCAAsC;SACzC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,kCAAkC,GAAG,sCAAsC;YAC3E,6EAA6E;YAC7E,yEAAyE;YACzE,oBAAoB;QACtB,iBAAiB,EACf,SAAS,GAAG,8DAA8D;YAC1E,2BAA2B;KAC9B,CAAC;AACJ,CAAC"}

package/dist/responsible-user-denial.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=responsible-user-denial.test.d.ts.map

package/dist/responsible-user-denial.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsible-user-denial.test.d.ts","sourceRoot":"","sources":["../src/responsible-user-denial.test.ts"],"names":[],"mappings":""}

package/dist/responsible-user-denial.test.js

@@ -0,0 +1,65 @@
+import { describe, expect, it } from "vitest";
+import { RESPONSIBLE_USER_DENIAL_CODES, describeResponsibleUserDenial, isResponsibleUserDenialCode, responsibleUserLabel, } from "./responsible-user-denial.js";
+describe("isResponsibleUserDenialCode", () => {
+    it("recognizes the two responsible-user denial codes", () => {
+        expect(isResponsibleUserDenialCode("RESPONSIBLE_USER_UNAUTHORIZED")).toBe(true);
+        expect(isResponsibleUserDenialCode("RESPONSIBLE_USER_UNAVAILABLE")).toBe(true);
+    });
+    it("rejects agent-lacks-permission and unrelated codes", () => {
+        expect(isResponsibleUserDenialCode("access_denied")).toBe(false);
+        expect(isResponsibleUserDenialCode("deny_missing_membership")).toBe(false);
+        expect(isResponsibleUserDenialCode(null)).toBe(false);
+        expect(isResponsibleUserDenialCode(undefined)).toBe(false);
+    });
+    it("covers every exported code", () => {
+        for (const code of RESPONSIBLE_USER_DENIAL_CODES) {
+            expect(isResponsibleUserDenialCode(code)).toBe(true);
+        }
+    });
+});
+describe("responsibleUserLabel", () => {
+    it("uses the display name when present", () => {
+        expect(responsibleUserLabel("Ada Lovelace")).toBe("Ada Lovelace");
+    });
+    it("falls back to a generic noun, never a raw id, when unknown", () => {
+        expect(responsibleUserLabel(null)).toBe("the responsible user");
+        expect(responsibleUserLabel(undefined)).toBe("the responsible user");
+        expect(responsibleUserLabel("   ")).toBe("the responsible user");
+    });
+});
+describe("describeResponsibleUserDenial", () => {
+    it("distinguishes unauthorized (user lacks permission) from unavailable", () => {
+        const unauthorized = describeResponsibleUserDenial("RESPONSIBLE_USER_UNAUTHORIZED");
+        const unavailable = describeResponsibleUserDenial("RESPONSIBLE_USER_UNAVAILABLE");
+        expect(unauthorized.tone).toBe("unauthorized");
+        expect(unavailable.tone).toBe("unavailable");
+        expect(unauthorized.title).not.toEqual(unavailable.title);
+        expect(unauthorized.description).not.toEqual(unavailable.description);
+    });
+    it("names the responsible user in unauthorized copy when known", () => {
+        const copy = describeResponsibleUserDenial("RESPONSIBLE_USER_UNAUTHORIZED", {
+            userName: "Ada Lovelace",
+        });
+        expect(copy.description).toContain("Ada Lovelace");
+        expect(copy.recommendedAction).toContain("Ada Lovelace");
+    });
+    it("uses generic phrasing when the responsible user name is unknown", () => {
+        const copy = describeResponsibleUserDenial("RESPONSIBLE_USER_UNAUTHORIZED");
+        expect(copy.description).toContain("the responsible user");
+    });
+    it("steers the unavailable case toward marking work blocked", () => {
+        const copy = describeResponsibleUserDenial("RESPONSIBLE_USER_UNAVAILABLE", {
+            userName: "Grace Hopper",
+        });
+        expect(copy.description).toContain("Grace Hopper");
+        expect(copy.recommendedAction.toLowerCase()).toContain("blocked");
+    });
+    it("never uses the word impersonate", () => {
+        for (const code of RESPONSIBLE_USER_DENIAL_CODES) {
+            const copy = describeResponsibleUserDenial(code, { userName: "Someone" });
+            const blob = `${copy.title} ${copy.description} ${copy.recommendedAction}`.toLowerCase();
+            expect(blob).not.toContain("impersonate");
+        }
+    });
+});
+//# sourceMappingURL=responsible-user-denial.test.js.map

package/dist/responsible-user-denial.test.js.map

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

package/dist/retired-composio.d.ts

@@ -0,0 +1,7 @@
+/** Persisted broker records must never fall through to generic MCP dispatch. */
+export declare function isRetiredComposioConnection(connection: {
+    transport: string;
+    config?: Record<string, unknown> | null;
+}): boolean;
+export declare const RETIRED_COMPOSIO_MESSAGE = "This legacy Composio connection is no longer supported. Add a new Composio MCP connection from Connectors, then remove this connection. Existing credentials and permissions are not migrated.";
+//# sourceMappingURL=retired-composio.d.ts.map

package/dist/retired-composio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-composio.d.ts","sourceRoot":"","sources":["../src/retired-composio.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzC,GAAG,OAAO,CAGV;AAED,eAAO,MAAM,wBAAwB,mMAC6J,CAAC"}

package/dist/retired-composio.js

@@ -0,0 +1,7 @@
+/** Persisted broker records must never fall through to generic MCP dispatch. */
+export function isRetiredComposioConnection(connection) {
+    return (connection.config?.sourceTemplateKey === "composio" && connection.transport === "rest_api")
+        || connection.config?.provider === "composio";
+}
+export const RETIRED_COMPOSIO_MESSAGE = "This legacy Composio connection is no longer supported. Add a new Composio MCP connection from Connectors, then remove this connection. Existing credentials and permissions are not migrated.";
+//# sourceMappingURL=retired-composio.js.map

package/dist/retired-composio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-composio.js","sourceRoot":"","sources":["../src/retired-composio.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,2BAA2B,CAAC,UAG3C;IACC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAiB,KAAK,UAAU,IAAI,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC;WAC9F,UAAU,CAAC,MAAM,EAAE,QAAQ,KAAK,UAAU,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GACnC,gMAAgM,CAAC"}

package/dist/routine-variables.d.ts

@@ -0,0 +1,23 @@
+import type { RoutineVariable } from "./types/routine.js";
+type RoutineTemplateInput = string | null | undefined | Array<string | null | undefined>;
+/**
+ * Built-in variable names that are automatically available in routine templates
+ * without needing to be defined in the routine's variables list.
+ */
+export declare const BUILTIN_ROUTINE_VARIABLE_NAMES: Set<string>;
+export declare function isBuiltinRoutineVariable(name: string): boolean;
+/**
+ * Returns current values for all built-in routine variables.
+ * `date` expands to the current date in YYYY-MM-DD format (UTC).
+ * `timestamp` expands to a human-readable date and time (e.g. "April 28, 2026 at 12:17 PM UTC").
+ */
+export declare function getBuiltinRoutineVariableValues(): Record<string, string>;
+export declare function isValidRoutineVariableName(name: string): boolean;
+export declare function isRoutineDateVariableName(name: string): boolean;
+export declare function isValidRoutineDateString(value: string): boolean;
+export declare function extractRoutineVariableNames(template: RoutineTemplateInput): string[];
+export declare function syncRoutineVariablesWithTemplate(template: RoutineTemplateInput, existing: RoutineVariable[] | null | undefined): RoutineVariable[];
+export declare function stringifyRoutineVariableValue(value: unknown): string;
+export declare function interpolateRoutineTemplate(template: string | null | undefined, values: Record<string, unknown> | null | undefined): string | null;
+export {};
+//# sourceMappingURL=routine-variables.d.ts.map

package/dist/routine-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-variables.d.ts","sourceRoot":"","sources":["../src/routine-variables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW1D,KAAK,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,aAAiC,CAAC;AAE7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAaD;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAyB/D;AAOD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAWpF;AAaD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,GAAG,SAAS,GAC7C,eAAe,EAAE,CAInB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASpE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,GAAG,IAAI,CAQf"}

package/dist/routine-variables.js

@@ -0,0 +1,127 @@
+// Tolerate markdown-escaped underscores (`\_`) inside placeholders. WYSIWYG markdown
+// editors (e.g. MDXEditor) serialize `_` between word chars as `\_` to prevent
+// reparse-as-emphasis, so a user-typed `{{pr_url}}` is stored as `{{pr\_url}}`.
+const ROUTINE_VARIABLE_MATCHER = /\{\{\s*([A-Za-z](?:\\_|[A-Za-z0-9_])*)\s*\}\}/g;
+function unescapeRoutineVariableName(raw) {
+    return raw.replace(/\\_/g, "_");
+}
+/**
+ * Built-in variable names that are automatically available in routine templates
+ * without needing to be defined in the routine's variables list.
+ */
+export const BUILTIN_ROUTINE_VARIABLE_NAMES = new Set(["date", "timestamp"]);
+export function isBuiltinRoutineVariable(name) {
+    return BUILTIN_ROUTINE_VARIABLE_NAMES.has(name);
+}
+const HUMAN_TIMESTAMP_FORMATTER = new Intl.DateTimeFormat("en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+    hour12: true,
+    timeZone: "UTC",
+    timeZoneName: "short",
+});
+/**
+ * Returns current values for all built-in routine variables.
+ * `date` expands to the current date in YYYY-MM-DD format (UTC).
+ * `timestamp` expands to a human-readable date and time (e.g. "April 28, 2026 at 12:17 PM UTC").
+ */
+export function getBuiltinRoutineVariableValues() {
+    const now = new Date();
+    return {
+        date: now.toISOString().slice(0, 10),
+        timestamp: HUMAN_TIMESTAMP_FORMATTER.format(now),
+    };
+}
+export function isValidRoutineVariableName(name) {
+    return /^[A-Za-z][A-Za-z0-9_]*$/.test(name);
+}
+export function isRoutineDateVariableName(name) {
+    return isValidRoutineVariableName(name) && name.length > "Date".length && name.endsWith("Date");
+}
+export function isValidRoutineDateString(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    if (month < 1 || month > 12)
+        return false;
+    const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+    const daysInMonth = [
+        31,
+        leapYear ? 29 : 28,
+        31,
+        30,
+        31,
+        30,
+        31,
+        31,
+        30,
+        31,
+        30,
+        31,
+    ][month - 1];
+    return day >= 1 && day <= daysInMonth;
+}
+function normalizeRoutineTemplateInput(input) {
+    const templates = Array.isArray(input) ? input : [input];
+    return templates.filter((template) => typeof template === "string" && template.length > 0);
+}
+export function extractRoutineVariableNames(template) {
+    const found = new Set();
+    for (const source of normalizeRoutineTemplateInput(template)) {
+        for (const match of source.matchAll(ROUTINE_VARIABLE_MATCHER)) {
+            const name = match[1] ? unescapeRoutineVariableName(match[1]) : "";
+            if (name && !found.has(name)) {
+                found.add(name);
+            }
+        }
+    }
+    return [...found];
+}
+function defaultRoutineVariable(name) {
+    return {
+        name,
+        label: null,
+        type: isRoutineDateVariableName(name) ? "date" : "text",
+        defaultValue: null,
+        required: true,
+        options: [],
+    };
+}
+export function syncRoutineVariablesWithTemplate(template, existing) {
+    const names = extractRoutineVariableNames(template).filter((name) => !isBuiltinRoutineVariable(name));
+    const existingByName = new Map((existing ?? []).map((variable) => [variable.name, variable]));
+    return names.map((name) => existingByName.get(name) ?? defaultRoutineVariable(name));
+}
+export function stringifyRoutineVariableValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (value == null)
+        return "";
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+export function interpolateRoutineTemplate(template, values) {
+    if (template == null)
+        return null;
+    if (!values || Object.keys(values).length === 0)
+        return template;
+    return template.replace(ROUTINE_VARIABLE_MATCHER, (match, rawName) => {
+        const name = unescapeRoutineVariableName(rawName);
+        if (!(name in values))
+            return match;
+        return stringifyRoutineVariableValue(values[name]);
+    });
+}
+//# sourceMappingURL=routine-variables.js.map

package/dist/routine-variables.js.map

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

package/dist/routine-variables.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routine-variables.test.d.ts.map

package/dist/routine-variables.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-variables.test.d.ts","sourceRoot":"","sources":["../src/routine-variables.test.ts"],"names":[],"mappings":""}

package/dist/routine-variables.test.js

@@ -0,0 +1,98 @@
+import { describe, expect, it } from "vitest";
+import { BUILTIN_ROUTINE_VARIABLE_NAMES, extractRoutineVariableNames, getBuiltinRoutineVariableValues, interpolateRoutineTemplate, isBuiltinRoutineVariable, isRoutineDateVariableName, isValidRoutineDateString, syncRoutineVariablesWithTemplate, } from "./routine-variables.js";
+describe("routine variable helpers", () => {
+    it("extracts placeholder names in first-appearance order", () => {
+        expect(extractRoutineVariableNames("Review {{repo}} and {{priority}} for {{repo}}")).toEqual(["repo", "priority"]);
+    });
+    it("deduplicates placeholder names across the routine title and description", () => {
+        expect(extractRoutineVariableNames([
+            "Triage {{repo}}",
+            "Review {{repo}} for {{priority}} bugs",
+        ])).toEqual(["repo", "priority"]);
+    });
+    it("preserves existing metadata when syncing variables from a template", () => {
+        expect(syncRoutineVariablesWithTemplate(["Triage {{repo}}", "Review {{repo}} and {{startDate}}"], [
+            { name: "repo", label: "Repository", type: "text", defaultValue: "paperclip", required: true, options: [] },
+            { name: "startDate", label: "Start", type: "text", defaultValue: "soon", required: false, options: [] },
+        ])).toEqual([
+            { name: "repo", label: "Repository", type: "text", defaultValue: "paperclip", required: true, options: [] },
+            { name: "startDate", label: "Start", type: "text", defaultValue: "soon", required: false, options: [] },
+        ]);
+    });
+    it("identifies routine date variable names by strict capital-Date suffix", () => {
+        expect(isRoutineDateVariableName("startDate")).toBe(true);
+        expect(isRoutineDateVariableName("endDate")).toBe(true);
+        expect(isRoutineDateVariableName("fooDate")).toBe(true);
+        expect(isRoutineDateVariableName("date")).toBe(false);
+        expect(isRoutineDateVariableName("startdate")).toBe(false);
+        expect(isRoutineDateVariableName("candidate")).toBe(false);
+        expect(isRoutineDateVariableName("Date")).toBe(false);
+    });
+    it("defaults newly synced capital-Date variables to date type", () => {
+        expect(syncRoutineVariablesWithTemplate("Compare {{startDate}} to {{endDate}} with {{date}}", [])).toEqual([
+            { name: "startDate", label: null, type: "date", defaultValue: null, required: true, options: [] },
+            { name: "endDate", label: null, type: "date", defaultValue: null, required: true, options: [] },
+        ]);
+    });
+    it("validates YYYY-MM-DD routine date strings as real calendar dates", () => {
+        expect(isValidRoutineDateString("2024-02-29")).toBe(true);
+        expect(isValidRoutineDateString("2024-02-30")).toBe(false);
+        expect(isValidRoutineDateString("2023-02-29")).toBe(false);
+        expect(isValidRoutineDateString("2024-13-01")).toBe(false);
+        expect(isValidRoutineDateString("2024-1-01")).toBe(false);
+    });
+    it("interpolates provided variable values into the routine template", () => {
+        expect(interpolateRoutineTemplate("Review {{repo}} for {{priority}}", {
+            repo: "paperclip",
+            priority: "high",
+        })).toBe("Review paperclip for high");
+    });
+    it("identifies built-in variable names", () => {
+        expect(isBuiltinRoutineVariable("date")).toBe(true);
+        expect(isBuiltinRoutineVariable("timestamp")).toBe(true);
+        expect(isBuiltinRoutineVariable("repo")).toBe(false);
+        expect(BUILTIN_ROUTINE_VARIABLE_NAMES.has("date")).toBe(true);
+        expect(BUILTIN_ROUTINE_VARIABLE_NAMES.has("timestamp")).toBe(true);
+    });
+    it("getBuiltinRoutineVariableValues returns date in YYYY-MM-DD format", () => {
+        const values = getBuiltinRoutineVariableValues();
+        expect(values.date).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        expect(values.date).toBe(new Date().toISOString().slice(0, 10));
+    });
+    it("getBuiltinRoutineVariableValues returns a human-readable timestamp with year, time, and UTC", () => {
+        const values = getBuiltinRoutineVariableValues();
+        const year = String(new Date().getUTCFullYear());
+        expect(values.timestamp).toContain(year);
+        expect(values.timestamp).toMatch(/\d{1,2}:\d{2}\s?(AM|PM)/);
+        expect(values.timestamp).toContain("UTC");
+    });
+    it("excludes built-in variables from syncRoutineVariablesWithTemplate", () => {
+        const result = syncRoutineVariablesWithTemplate("Daily report for {{date}} at {{timestamp}} — {{repo}}", []);
+        expect(result).toEqual([
+            { name: "repo", label: null, type: "text", defaultValue: null, required: true, options: [] },
+        ]);
+    });
+    it("extracts snake_case variable names", () => {
+        expect(extractRoutineVariableNames("Open {{pr_url}} for review")).toEqual(["pr_url"]);
+    });
+    it("extracts variable names whose underscores were markdown-escaped by a WYSIWYG editor", () => {
+        // MDXEditor / mdast-util-to-markdown defensively escape intraword underscores
+        // when serializing rich-text back to markdown, so `{{pr_url}}` is stored as `{{pr\_url}}`.
+        expect(extractRoutineVariableNames("Open {{pr\\_url}} for review")).toEqual(["pr_url"]);
+        expect(extractRoutineVariableNames("{{pr\\_url\\_v2}}")).toEqual(["pr_url_v2"]);
+    });
+    it("syncRoutineVariablesWithTemplate handles markdown-escaped underscores", () => {
+        expect(syncRoutineVariablesWithTemplate("Open {{pr\\_url}}", [])).toEqual([
+            { name: "pr_url", label: null, type: "text", defaultValue: null, required: true, options: [] },
+        ]);
+    });
+    it("interpolates variables that appear with markdown-escaped underscores", () => {
+        expect(interpolateRoutineTemplate("Open {{pr\\_url}}", { pr_url: "https://example.com" })).toBe("Open https://example.com");
+    });
+    it("interpolates built-in variables alongside user variables", () => {
+        const builtins = getBuiltinRoutineVariableValues();
+        const allVars = { ...builtins, repo: "paperclip" };
+        expect(interpolateRoutineTemplate("Report for {{date}} ({{timestamp}}) on {{repo}}", allVars)).toBe(`Report for ${builtins.date} (${builtins.timestamp}) on paperclip`);
+    });
+});
+//# sourceMappingURL=routine-variables.test.js.map

package/dist/routine-variables.test.js.map

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