terse-types 0.0.29 → 0.0.31

package/dist/Tools.js

@@ -26,7 +26,6 @@ export const linearIssueAssigneeSchema = z.object({
     name: z.string(),
     email: z.string().optional()
 });
-export const linearIssueTeamSchema = linearTeamSchema;
 export const linearIssueProjectSchema = z.object({
     id: z.string(),
     name: z.string()
@@ -44,7 +43,7 @@ export const linearIssueSummarySchema = z.object({
     updatedAt: dateLikeSchema
 });
 export const linearIssueDetailSchema = linearIssueSummarySchema.extend({
-    team: linearIssueTeamSchema.nullable(),
+    team: linearTeamSchema.nullable(),
     project: linearIssueProjectSchema.nullable(),
     dueDate: dateLikeSchema.optional(),
     estimate: z.number().nullable().optional()
@@ -225,7 +224,6 @@ export const notionReadablePropertyValueSchema = z.union([
     z.array(notionFileReferenceSchema),
     notionLooseObjectSchema
 ]);
-export const notionPageParentSchema = notionLooseObjectSchema;
 export const notionPageBlockSchema = z.lazy(() => z.object({
     id: z.string(),
     type: z.string(),
@@ -262,7 +260,7 @@ export const notionPageQueryMetadataSchema = z.object({
     archived: z.boolean().optional(),
     icon: notionLooseObjectSchema.nullable().optional(),
     cover: notionLooseObjectSchema.nullable().optional(),
-    parent: notionPageParentSchema.optional(),
+    parent: notionLooseObjectSchema.optional(),
     created_by: notionUserReferenceSchema.optional(),
     last_edited_by: notionUserReferenceSchema.optional(),
     in_trash: z.boolean().optional()
@@ -573,7 +571,7 @@ export const slackReadConversationInputSchema = z.object({
 export const searchGitHubCodeInputSchema = z.object({
     repositoryNames: z.array(z.string()).describe("Array of repository full names (owner/repo format) to search in."),
     query: z.string().describe('The search query. Use natural language or code-specific terms. Examples: "authentication middleware", "class UserRepository", "handleSubmit form validation"'),
-    language: z.string().nullable().optional().describe('Filter by programming language (e.g., "typescript", "python", "javascript"). Use null to search all languages.'),
+    language: z.string().nullable().optional().describe('Filter by programming language (e.g., "typescript", "javascript"). Use null to search all languages.'),
     filename: z.string().nullable().optional().describe('Filter by filename pattern (e.g., "*.test.ts" for test files, "*.config.*" for config files). Use null to search all files.'),
     path: z.string().nullable().optional().describe('Filter by path (e.g., "src/components" to only search in that directory). Use null to search everywhere.'),
     perPage: z.number().int().describe("Number of results to return (default: 10, max: 100)"),

package/dist/WorkOSMetadata.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const organizationMetadataSchema: z.ZodObject<{
+    subscriptionPurchaserUserId: z.ZodOptional<z.ZodString>;
+    subscriptionId: z.ZodOptional<z.ZodString>;
+    metronomeCustomerId: z.ZodOptional<z.ZodString>;
+    runExecutionBlocked: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>, z.ZodTransform<boolean, string | boolean | undefined>>;
+}, z.core.$strip>;
+export type OrganizationMetadata = z.infer<typeof organizationMetadataSchema>;
+export declare const userMetadataSchema: z.ZodObject<{
+    db_id: z.ZodOptional<z.ZodString>;
+    stripeCustomerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UserMetadata = z.infer<typeof userMetadataSchema>;

package/dist/WorkOSMetadata.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+// Can be serialized a string, supports deserialization
+const booleanMetadataSchema = z
+    .union([z.boolean(), z.string()])
+    .optional()
+    .transform(value => value === true || value === "true");
+export const organizationMetadataSchema = z.object({
+    subscriptionPurchaserUserId: z.string().optional(),
+    subscriptionId: z.string().optional(),
+    metronomeCustomerId: z.string().optional(),
+    runExecutionBlocked: booleanMetadataSchema
+});
+export const userMetadataSchema = z.object({
+    db_id: z.string().optional(),
+    stripeCustomerId: z.string().optional()
+});

package/dist/getConfigACLRules.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure config-to-ACL derivation (no network I/O).
+ *
+ * ACL and `readOnly` apply only to model-selected tool calls during agent runs; see `ACL.ts`
+ * for the full product contract.
+ */
+import type { ACLRule } from "./ACL.js";
+import type { ConfigData } from "./Configs.js";
+export declare function getConfigACLRules(config: ConfigData): ACLRule[];
+export declare function getMergedACLRules(configs: ConfigData[]): ACLRule[];

package/dist/getConfigACLRules.js

@@ -0,0 +1,313 @@
+import { ConfigType } from "./Configs.js";
+import { IntegrationType } from "./Integrations.js";
+function assertNever(value) {
+    throw new Error(`Unhandled config type: ${JSON.stringify(value)}`);
+}
+// Slack
+function getSlackOutputConfigACLRules(config) {
+    const rules = [];
+    if (config.channelId) {
+        rules.push({
+            integrationType: IntegrationType.SLACK,
+            integrationId: config.integrationId,
+            resourceType: "channel",
+            resourceId: config.channelId
+        });
+    }
+    for (const userId of config.userIds ?? []) {
+        rules.push({
+            integrationType: IntegrationType.SLACK,
+            integrationId: config.integrationId,
+            resourceType: "dm_user",
+            resourceId: userId
+        });
+    }
+    return rules;
+}
+function getSlackInputConfigACLRules(config) {
+    const rules = [];
+    if (config.channelId) {
+        rules.push({
+            integrationType: IntegrationType.SLACK,
+            integrationId: config.integrationId,
+            resourceType: "channel",
+            resourceId: config.channelId
+        });
+    }
+    for (const userId of config.userIds ?? []) {
+        rules.push({
+            integrationType: IntegrationType.SLACK,
+            integrationId: config.integrationId,
+            resourceType: "dm_user",
+            resourceId: userId
+        });
+    }
+    return rules;
+}
+// Notion
+function getNotionConfigACLRules(config) {
+    return [
+        ...(config.pageIds ?? []).map((pageId) => ({
+            integrationType: IntegrationType.NOTION,
+            integrationId: config.integrationId,
+            resourceType: "page",
+            resourceId: pageId
+        })),
+        ...(config.databaseIds ?? []).map((databaseId) => ({
+            integrationType: IntegrationType.NOTION,
+            integrationId: config.integrationId,
+            resourceType: "database",
+            resourceId: databaseId
+        }))
+    ];
+}
+// Gmail
+function getGmailOutputConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.GMAIL,
+            integrationId: config.integrationId,
+            resourceType: "send",
+            resourceId: "send"
+        }
+    ];
+}
+function getGmailDraftOutputConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.GMAIL,
+            integrationId: config.integrationId,
+            resourceType: "draft",
+            resourceId: "draft"
+        }
+    ];
+}
+// Terse built-in capabilities
+function getWebConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.TERSE,
+            integrationId: config.integrationId,
+            resourceType: "web_capability",
+            resourceId: "system"
+        }
+    ];
+}
+function getImageEditConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.TERSE,
+            integrationId: config.integrationId,
+            resourceType: "image_edit_capability",
+            resourceId: "system"
+        }
+    ];
+}
+// Linear
+function getLinearInputConfigACLRules(config) {
+    const rules = [
+        {
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+    if (config.teamId) {
+        rules.push({
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "team",
+            resourceId: config.teamId
+        });
+    }
+    if (config.projectId) {
+        rules.push({
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "project",
+            resourceId: config.projectId
+        });
+    }
+    return rules;
+}
+function getLinearOutputConfigACLRules(config) {
+    const rules = [
+        {
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+    if (config.teamId) {
+        rules.push({
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "team",
+            resourceId: config.teamId
+        });
+    }
+    if (config.projectId) {
+        rules.push({
+            integrationType: IntegrationType.LINEAR,
+            integrationId: config.integrationId,
+            resourceType: "project",
+            resourceId: config.projectId
+        });
+    }
+    return rules;
+}
+// PostHog
+function getPosthogConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.POSTHOG,
+            integrationId: config.integrationId,
+            resourceType: "project",
+            resourceId: config.projectId
+        }
+    ];
+}
+// Datadog
+function getDatadogConfigACLRules(config) {
+    const rules = [
+        {
+            integrationType: IntegrationType.DATADOG,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+    for (const indexName of config.defaultIndexes ?? []) {
+        rules.push({
+            integrationType: IntegrationType.DATADOG,
+            integrationId: config.integrationId,
+            resourceType: "index",
+            resourceId: indexName
+        });
+    }
+    return rules;
+}
+// LaunchDarkly
+function getLaunchDarklyConfigACLRules(config) {
+    const rules = [
+        {
+            integrationType: IntegrationType.LAUNCHDARKLY,
+            integrationId: config.integrationId,
+            resourceType: "project",
+            resourceId: config.projectKey
+        }
+    ];
+    for (const envKey of config.environmentKeys) {
+        rules.push({
+            integrationType: IntegrationType.LAUNCHDARKLY,
+            integrationId: config.integrationId,
+            resourceType: "environment",
+            resourceId: `${config.projectKey}:${envKey}`
+        });
+    }
+    return rules;
+}
+// WorkOS
+function getWorkOSInputConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.WORKOS,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+}
+function getWorkOSOutputConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.WORKOS,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+}
+// Attio
+function getAttioOutputConfigACLRules(config) {
+    const rules = [
+        {
+            integrationType: IntegrationType.ATTIO,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+    if (config.objectSlug) {
+        rules.push({
+            integrationType: IntegrationType.ATTIO,
+            integrationId: config.integrationId,
+            resourceType: "object",
+            resourceId: config.objectSlug
+        });
+    }
+    return rules;
+}
+// Snowflake
+function getSnowflakeOutputConfigACLRules(config) {
+    return [
+        {
+            integrationType: IntegrationType.SNOWFLAKE,
+            integrationId: config.integrationId,
+            resourceType: "integration",
+            resourceId: config.integrationId
+        }
+    ];
+}
+export function getConfigACLRules(config) {
+    switch (config.configType) {
+        // Input/trigger-only configs do not grant model-selected output tool ACL.
+        case ConfigType.GMAIL:
+        case ConfigType.TIME_TRIGGER:
+        case ConfigType.WEBHOOK_INPUT:
+        case ConfigType.WEBMONITOR:
+            return [];
+        case ConfigType.SLACK:
+            return getSlackInputConfigACLRules(config);
+        case ConfigType.SLACK_OUTPUT:
+            return getSlackOutputConfigACLRules(config);
+        case ConfigType.NOTION:
+            return getNotionConfigACLRules(config);
+        case ConfigType.LINEAR_INPUT:
+            return getLinearInputConfigACLRules(config);
+        case ConfigType.LINEAR_OUTPUT:
+            return getLinearOutputConfigACLRules(config);
+        case ConfigType.GITHUB:
+            // GitHub repository IDs require backend hydration to owner/repo names.
+            return [];
+        case ConfigType.GMAIL_OUTPUT:
+            return getGmailOutputConfigACLRules(config);
+        case ConfigType.GMAIL_DRAFT_OUTPUT:
+            return getGmailDraftOutputConfigACLRules(config);
+        case ConfigType.POSTHOG:
+            return getPosthogConfigACLRules(config);
+        case ConfigType.DATADOG:
+            return getDatadogConfigACLRules(config);
+        case ConfigType.LAUNCHDARKLY:
+            return getLaunchDarklyConfigACLRules(config);
+        case ConfigType.WEB:
+            return getWebConfigACLRules(config);
+        case ConfigType.IMAGE_EDIT:
+            return getImageEditConfigACLRules(config);
+        case ConfigType.WORKOS_INPUT:
+            return getWorkOSInputConfigACLRules(config);
+        case ConfigType.WORKOS_OUTPUT:
+            return getWorkOSOutputConfigACLRules(config);
+        case ConfigType.ATTIO_OUTPUT:
+            return getAttioOutputConfigACLRules(config);
+        case ConfigType.SNOWFLAKE_OUTPUT:
+            return getSnowflakeOutputConfigACLRules(config);
+        default:
+            return assertNever(config);
+    }
+}
+export function getMergedACLRules(configs) {
+    return configs.flatMap(getConfigACLRules);
+}

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export * from "./ApprovalTypes.js";
 export * from "./ClientBoundTools.js";
 export * from "./Configs.js";
 export * from "./DonatedState.js";
-export * from "./Entities.js";
 export * from "./FrontendRoutesBuilder.js";
+export * from "./Entities.js";
+export * from "./Decision.js";
 export * from "./Integrations.js";
 export * from "./InvalidationKeys.js";
 export * from "./JsonSchemaUtils.js";
@@ -13,13 +14,13 @@ export * from "./Notifications.js";
 export * from "./RunHistoryTypes.js";
 export * from "./SentNotifications.js";
 export * from "./SlackTypes.js";
-export * from "./OrganizationMetadata.js";
+export * from "./WorkOSMetadata.js";
 export * from "./SocketEvents.js";
 export * from "./Survey.js";
 export * from "./Tools.js";
 export * from "./Billing.js";
 export * from "./ModelRegistry.js";
-export { Comment, CreateTicketInput, LinearStateName, Milestone, Organization, Project, Team, Ticket, TicketState, TicketSystemType, TicketWebhookHandler, Update, UpdateTicketInput, UserContext } from "./TicketSystem.js";
+export * from "./TicketSystem.js";
 export * from "./ToolDisplayUtils.js";
 export * from "./Triggers.js";
 export * from "./ToolsTypes.js";

package/dist/index.js

@@ -3,8 +3,9 @@ export * from "./ApprovalTypes.js";
 export * from "./ClientBoundTools.js";
 export * from "./Configs.js";
 export * from "./DonatedState.js";
-export * from "./Entities.js";
 export * from "./FrontendRoutesBuilder.js";
+export * from "./Entities.js";
+export * from "./Decision.js";
 export * from "./Integrations.js";
 export * from "./InvalidationKeys.js";
 export * from "./JsonSchemaUtils.js";
@@ -13,13 +14,13 @@ export * from "./Notifications.js";
 export * from "./RunHistoryTypes.js";
 export * from "./SentNotifications.js";
 export * from "./SlackTypes.js";
-export * from "./OrganizationMetadata.js";
+export * from "./WorkOSMetadata.js";
 export * from "./SocketEvents.js";
 export * from "./Survey.js";
 export * from "./Tools.js";
 export * from "./Billing.js";
 export * from "./ModelRegistry.js";
-export { LinearStateName, TicketSystemType } from "./TicketSystem.js";
+export * from "./TicketSystem.js";
 export * from "./ToolDisplayUtils.js";
 export * from "./Triggers.js";
 export * from "./ToolsTypes.js";

package/dist/types.d.ts

@@ -1031,11 +1031,11 @@ export declare const runHistoryRecordSchema: z.ZodObject<{
         step_id: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>;
         isReadOnly: z.ZodOptional<z.ZodBoolean>;
         output_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1083,11 +1083,11 @@ export declare const runHistoryRecordWithAgentSchema: z.ZodObject<{
         step_id: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>;
         isReadOnly: z.ZodOptional<z.ZodBoolean>;
         output_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1111,11 +1111,11 @@ export declare const agentNotificationSettingsSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     actionTypes: z.ZodArray<z.ZodEnum<{
         error: "error";
+        approve: "approve";
         create: "create";
         update: "update";
         delete: "delete";
         read: "read";
-        approve: "approve";
     }>>;
 }, z.core.$strip>;
 export type AgentNotificationSettings = z.infer<typeof agentNotificationSettingsSchema>;
@@ -1477,11 +1477,11 @@ export declare const agentSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         actionTypes: z.ZodArray<z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>>;
     }, z.core.$strip>>;
     toolApprovals: z.ZodNullable<z.ZodArray<z.ZodString>>;
@@ -1847,11 +1847,11 @@ export declare const agentUpdateSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         actionTypes: z.ZodArray<z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>>;
     }, z.core.$strip>>>;
     toolApprovals: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
@@ -2212,11 +2212,11 @@ export declare const agentCreateSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         actionTypes: z.ZodArray<z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>>;
     }, z.core.$strip>>;
     toolApprovals: z.ZodNullable<z.ZodArray<z.ZodString>>;
@@ -2577,11 +2577,11 @@ export declare const agentDraftSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         actionTypes: z.ZodArray<z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>>;
     }, z.core.$strip>>;
     toolApprovals: z.ZodNullable<z.ZodArray<z.ZodString>>;
@@ -2948,11 +2948,11 @@ export declare const agentsResponseSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             actionTypes: z.ZodArray<z.ZodEnum<{
                 error: "error";
+                approve: "approve";
                 create: "create";
                 update: "update";
                 delete: "delete";
                 read: "read";
-                approve: "approve";
             }>>;
         }, z.core.$strip>>;
         toolApprovals: z.ZodNullable<z.ZodArray<z.ZodString>>;
@@ -3327,11 +3327,11 @@ export declare const recentAgentSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         actionTypes: z.ZodArray<z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>>;
     }, z.core.$strip>>;
     toolApprovals: z.ZodNullable<z.ZodArray<z.ZodString>>;
@@ -3598,11 +3598,11 @@ export declare const recentActionSchema: z.ZodObject<{
     agentName: z.ZodString;
     type: z.ZodEnum<{
         error: "error";
+        approve: "approve";
         create: "create";
         update: "update";
         delete: "delete";
         read: "read";
-        approve: "approve";
     }>;
 }, z.core.$strip>;
 export type RecentAction = z.infer<typeof recentActionSchema>;
@@ -3638,11 +3638,11 @@ export declare const statsResponseSchema: z.ZodObject<{
         agentName: z.ZodString;
         type: z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>;
     }, z.core.$strip>>;
     recentRuns: z.ZodArray<z.ZodObject<{
@@ -3674,11 +3674,11 @@ export declare const statsResponseSchema: z.ZodObject<{
             step_id: z.ZodOptional<z.ZodString>;
             type: z.ZodEnum<{
                 error: "error";
+                approve: "approve";
                 create: "create";
                 update: "update";
                 delete: "delete";
                 read: "read";
-                approve: "approve";
             }>;
             isReadOnly: z.ZodOptional<z.ZodBoolean>;
             output_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5401,11 +5401,11 @@ export declare const actionSchema: z.ZodObject<{
         step_id: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>;
         isReadOnly: z.ZodOptional<z.ZodBoolean>;
         output_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5473,11 +5473,11 @@ export declare const sdkAgentStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         step_id: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
             error: "error";
+            approve: "approve";
             create: "create";
             update: "update";
             delete: "delete";
             read: "read";
-            approve: "approve";
         }>;
         isReadOnly: z.ZodOptional<z.ZodBoolean>;
         output_items: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-types",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "type": "module",
   "description": "Shared Terse TypeScript types, enums, constants, and helpers.",
   "main": "./dist/index.js",
@@ -34,17 +34,14 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@slack/types": "^2.20.1",
     "@slack/web-api": "^7.15.0",
     "zod": "4.3.6"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && node --input-type=module -e \"import { fix } from 'tsc-esm-fix'; await fix({ cwd: process.cwd(), target: ['dist'], ext: '.js' })\"",
     "check:schema": "node --import tsx scripts/check-schema-compat.ts",
-    "build:json-schema": "node --import tsx scripts/export-json-schema.ts",
     "clean": "rm -rf dist",
     "dev": "node ../scripts/tsc-watch-and-fix.mjs tsconfig.build.json dist",
-    "dev:python-types": "node scripts/dev-with-codegen.mjs",
     "format": "pnpm exec prettier --config ../.prettierrc --write \"*.{ts,json}\"",
     "format:check": "pnpm exec prettier --config ../.prettierrc --check \"*.{ts,json}\""
   }