terse-types 0.0.2 → 0.0.4

package/dist/types.js

@@ -1,13 +1,10 @@
 import * as z from "zod";
-import { configDataSchema, configTypeEnum } from "./Configs.js";
+import { configDataSchema, configTypeEnum, skillConfigDataSchema, triggerConfigDataSchema } from "./Configs.js";
 import { integrationTypeEnum } from "./Integrations.js";
-import { RUN_HISTORY_ACTION_TYPES, RunHistoryStatus, runHistoryActionBaseSchema } from "./RunHistoryTypes.js";
+import { runHistoryActionBaseSchema, runHistoryActionTypeSchema, runHistoryDecisionActionSchema, runHistoryStatusSchema } from "./RunHistoryTypes.js";
+import { SlackChannelType, slackChannelTypeSchema } from "./SlackTypes.js";
 import { slackUserResponseSchema } from "./Tools.js";
-const pointSchema = z.object({
-    x: z.number(),
-    y: z.number()
-});
-const unknownRecordSchema = z.record(z.string(), z.unknown());
+import { TriggerSchema, serializedEventSchema } from "./Triggers.js";
 export const roleSchema = z.enum(["admin", "user"]);
 export const userSchema = z.object({
     id: z.string(),
@@ -47,16 +44,6 @@ export const linearWorkspaceSchema = z.object({
     id: z.string(),
     name: z.string()
 });
-export const jiraProjectSchema = z.object({
-    id: z.string(),
-    key: z.string(),
-    name: z.string()
-});
-export const jiraCredentialsValidationResponseSchema = z.object({
-    valid: z.boolean(),
-    projects: z.array(jiraProjectSchema).optional(),
-    error: z.string().optional()
-});
 export const notionResourceTypeSchema = z.enum(["database", "page"]);
 export const notionResourceSchema = z.object({
     id: z.string(),
@@ -123,173 +110,7 @@ export const terseAgentMessageMetadataSchema = z.object({
     event_type: z.literal(TERSE_AGENT_MESSAGE_EVENT_TYPE),
     event_payload: terseAgentMessageEventPayloadSchema
 });
-export var SlackChannelType;
-(function (SlackChannelType) {
-    SlackChannelType["CHANNEL"] = "channel";
-    SlackChannelType["GROUP"] = "group";
-    SlackChannelType["MPIM"] = "mpim";
-    SlackChannelType["IM"] = "im";
-})(SlackChannelType || (SlackChannelType = {}));
-export const slackChannelTypeSchema = z.enum(SlackChannelType);
-export const confluencePageSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    spaceId: z.string(),
-    spaceName: z.string(),
-    url: z.string(),
-    status: z.string(),
-    version: z.number().int()
-});
-export const confluencePagesQuerySchema = z
-    .object({
-    integrationId: z.string(),
-    spaceId: z.string().optional(),
-    spaceKey: z.string().optional()
-})
-    .refine(({ spaceId, spaceKey }) => spaceId != null || spaceKey != null, {
-    message: "Either spaceId or spaceKey is required"
-});
-export const confluencePagesResponseSchema = z.object({
-    pages: z.array(confluencePageSchema),
-    spaceId: z.string(),
-    total: z.number().int()
-});
-export const confluenceResourcesResponseSchema = z.object({
-    resources: z.array(confluencePageSchema),
-    spaceId: z.string(),
-    total: z.number().int()
-});
-export const jiraResourceProjectSchema = z.object({
-    id: z.string(),
-    key: z.string(),
-    name: z.string(),
-    projectTypeKey: z.string()
-});
-export const jiraResourcesPayloadSchema = z.object({
-    projects: z.array(jiraResourceProjectSchema),
-    baseUrl: z.string(),
-    cloudId: z.string()
-});
-export const jiraResourcesResponseSchema = z.object({
-    success: z.boolean(),
-    resources: jiraResourcesPayloadSchema
-});
-export const useConfluenceResourcesReturnBaseSchema = z.object({
-    resources: z.array(confluencePageSchema),
-    response: confluenceResourcesResponseSchema.optional(),
-    isLoading: z.boolean(),
-    isError: z.boolean(),
-    error: z.unknown(),
-    isValidating: z.boolean()
-});
-export const createUseConfluenceResourcesReturnSchema = (mutateSchema) => useConfluenceResourcesReturnBaseSchema.extend({
-    mutate: mutateSchema
-});
-export var FigmaEventTypes;
-(function (FigmaEventTypes) {
-    FigmaEventTypes["FILE_COMMENT"] = "FILE_COMMENT";
-})(FigmaEventTypes || (FigmaEventTypes = {}));
-export const figmaEventTypesSchema = z.enum(FigmaEventTypes);
-export const figmaWebhookUserSchema = z.object({
-    id: z.string(),
-    handle: z.string(),
-    email: z.string(),
-    img_url: z.string()
-});
-export const figmaCommentImageUrlsSchema = z.object({
-    nodeImage: z.string().optional(),
-    fullFrame: z.string().optional()
-});
-export const figmaVectorDataSchema = pointSchema;
-export const figmaFrameOffsetDataSchema = z.object({
-    node_id: z.string(),
-    node_offset: pointSchema
-});
-export const figmaRegionDataSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-    width: z.number(),
-    height: z.number()
-});
-export const figmaFrameOffsetRegionDataSchema = z.object({
-    node_id: z.string(),
-    node_offset: pointSchema,
-    x: z.number(),
-    y: z.number(),
-    width: z.number(),
-    height: z.number()
-});
-export const figmaVectorPositioningSchema = z.object({ type: z.literal("Vector"), data: figmaVectorDataSchema });
-export const figmaFrameOffsetPositioningSchema = z.object({ type: z.literal("FrameOffset"), data: figmaFrameOffsetDataSchema });
-export const figmaRegionPositioningSchema = z.object({ type: z.literal("Region"), data: figmaRegionDataSchema });
-export const figmaFrameOffsetRegionPositioningSchema = z.object({ type: z.literal("FrameOffsetRegion"), data: figmaFrameOffsetRegionDataSchema });
-export const figmaPositioningDataSchema = z.discriminatedUnion("type", [
-    figmaVectorPositioningSchema,
-    figmaFrameOffsetPositioningSchema,
-    figmaRegionPositioningSchema,
-    figmaFrameOffsetRegionPositioningSchema
-]);
-export const figmaClientMetaSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-    width: z.number(),
-    height: z.number(),
-    node_id: z.string(),
-    node_offset: pointSchema
-});
-export const figmaWebhookCommentSchema = z.object({
-    id: z.string(),
-    message: z.string(),
-    client_meta: figmaClientMetaSchema,
-    user: figmaWebhookUserSchema,
-    created_at: z.string(),
-    resolved_at: z.string().nullable()
-});
-export const figmaApiCommentSchema = z.object({
-    id: z.string(),
-    message: z.string(),
-    client_meta: figmaClientMetaSchema.nullable(),
-    user: figmaWebhookUserSchema,
-    created_at: z.string(),
-    resolved_at: z.string().nullable(),
-    parent_id: z.string().nullable().optional(),
-    order_id: z.string().optional(),
-    mentions: z.array(z.unknown()).optional(),
-    reactions: z.array(z.unknown()).optional()
-});
-export const figmaCommentThreadEntrySchema = z.object({
-    id: z.string(),
-    message: z.string(),
-    author: figmaWebhookUserSchema,
-    createdAt: z.string(),
-    resolvedAt: z.string().nullable(),
-    parentId: z.string().nullable(),
-    orderId: z.string().optional(),
-    isRoot: z.boolean().optional()
-});
-export const figmaFileMetadataSchema = z
-    .object({
-    name: z.string().optional(),
-    folder_name: z.string().optional(),
-    url: z.string().optional()
-})
-    .passthrough();
-export const figmaCommentEventDataSchema = z.object({
-    integrationId: z.string(),
-    commentId: z.string(),
-    fileKey: z.string(),
-    fileUrl: z.string(),
-    nodeId: z.string().optional(),
-    message: z.string(),
-    author: figmaWebhookUserSchema,
-    createdAt: z.string(),
-    resolved: z.boolean().optional(),
-    thread: z.array(figmaCommentThreadEntrySchema).optional(),
-    fileMetadata: figmaFileMetadataSchema.optional(),
-    positioningData: figmaPositioningDataSchema.optional(),
-    matchedNodeIds: z.array(z.string()).optional(),
-    imageUrls: figmaCommentImageUrlsSchema.optional()
-});
+export { SlackChannelType, slackChannelTypeSchema };
 export const apiTokenSchema = z.object({
     id: z.string(),
     name: z.string(),
@@ -311,16 +132,21 @@ export const deviceTokenExchangeResponseSchema = z.object({
     user: deviceTokenExchangeUserSchema
 });
 const configInstanceDataSchema = configDataSchema;
+export const triggerMetadataSchema = z.object({
+    webhookUrl: z.string().nullable().optional()
+});
 export const agentTriggerSchema = z.object({
     id: z.string(),
-    config: configInstanceDataSchema
+    config: configInstanceDataSchema,
+    metadata: triggerMetadataSchema.nullable().optional()
 });
 export const agentOutputSchema = z.object({
     id: z.string(),
     config: configInstanceDataSchema
 });
 export const agentPromptSchema = z.object({
-    text: z.string()
+    text: z.string(),
+    remoteServerUrl: z.string().optional()
 });
 export const transientAgentTriggerSchema = z.object({
     id: z.string(),
@@ -355,9 +181,7 @@ export const agentTemplateSchema = z.object({
     requireApproval: z.boolean(),
     isActive: z.boolean()
 });
-const runHistoryActionTypeSchema = z.enum(RUN_HISTORY_ACTION_TYPES);
-const runHistoryStatusSchema = z.enum(RunHistoryStatus);
-const runHistoryTriggerSchema = z.object({
+export const runHistoryTriggerSchema = z.object({
     event: z.string(),
     integration: integrationTypeEnum,
     source: z.string(),
@@ -365,11 +189,11 @@ const runHistoryTriggerSchema = z.object({
     subheader: z.string().optional(),
     url: z.string().optional()
 });
-const runHistoryDecisionSchema = z.object({
-    action: z.enum(["processed", "skipped"]),
+export const runHistoryDecisionSchema = z.object({
+    action: runHistoryDecisionActionSchema,
     reasoning: z.string()
 });
-const runHistoryRecordSchema = z.object({
+export const runHistoryRecordSchema = z.object({
     id: z.string(),
     agentId: z.string(),
     timestamp: z.string(),
@@ -380,7 +204,7 @@ const runHistoryRecordSchema = z.object({
     status: runHistoryStatusSchema,
     isManuallyTriggered: z.boolean()
 });
-const runHistoryRecordWithAgentSchema = runHistoryRecordSchema.extend({
+export const runHistoryRecordWithAgentSchema = runHistoryRecordSchema.extend({
     agentName: z.string()
 });
 export const agentNotificationSettingsSchema = z.object({
@@ -566,32 +390,14 @@ export const statsResponseSchema = z.object({
     actionIntegrations: z.array(countByStringSchema),
     actionTypes: z.array(countByStringSchema)
 });
-export const triggerPayloadSchema = z.object({
-    integrationId: z.string(),
-    integrationType: integrationTypeEnum,
-    config: configDataSchema
-});
-export const serializedEventSchema = z.object({
-    integrationType: integrationTypeEnum,
-    eventType: z.string().optional(),
-    formattedContent: z.string(),
-    debugLog: z.string(),
-    metadata: unknownRecordSchema.optional()
-});
-export const sdkAgentRunEventPayloadSchema = z.object({
-    integrationType: integrationTypeEnum,
-    formattedContent: z.string(),
-    debugLog: z.string()
-});
-export const partialSdkAgentRunEventPayloadSchema = sdkAgentRunEventPayloadSchema.partial();
 export const sdkAgentRunOptionsPayloadSchema = z.object({
     maxTurns: z.number().int().optional(),
     requireApproval: z.boolean().optional()
 });
 export const sdkAgentRunRequestBodySchema = z.object({
     prompt: z.string().optional(),
-    event: partialSdkAgentRunEventPayloadSchema.optional(),
-    skills: z.array(configDataSchema).optional(),
+    event: TriggerSchema.optional(),
+    skills: z.array(skillConfigDataSchema).optional(),
     options: sdkAgentRunOptionsPayloadSchema.optional(),
     toolApprovals: z.array(z.string()).optional()
 });
@@ -605,8 +411,8 @@ export const sdkAgentRunNormalizedRequestOptionsSchema = z.object({
 });
 export const sdkAgentRunNormalizedRequestSchema = z.object({
     prompt: z.string(),
-    event: sdkAgentRunEventPayloadSchema,
-    skills: z.array(configDataSchema),
+    event: TriggerSchema,
+    skills: z.array(skillConfigDataSchema),
     toolApprovals: z.array(z.string()),
     options: sdkAgentRunNormalizedRequestOptionsSchema
 });
@@ -622,20 +428,30 @@ export const toolApprovalRequestedPayloadSchema = z.object({
     toolName: z.string(),
     arguments: z.string()
 });
+export const runStartedSchema = z.object({ type: z.literal("run_started"), runId: z.string() });
+export const textSchema = z.object({ type: z.literal("text"), text: z.string() });
+export const finalOutputSchema = z.object({ type: z.literal("final_output"), finalOutput: z.string() });
+export const toolCallParamsSchema = z.object({ type: z.literal("tool_call_params"), toolCallParams: z.string() });
+export const toolCallStartedSchema = z.object({ type: z.literal("tool_call_started"), toolCallStarted: z.string() });
+export const toolCallCompletedSchema = z.object({ type: z.literal("tool_call_completed"), toolCallCompleted: z.string() });
+export const toolApprovalRequestedSchema = z.object({
+    type: z.literal("tool_approval_requested"),
+    toolApprovalRequested: toolApprovalRequestedPayloadSchema
+});
+export const actionSchema = z.object({ type: z.literal("action"), action: runHistoryActionBaseSchema });
+export const errorSchema = z.object({ type: z.literal("error"), message: z.string() });
+export const doneSchema = z.object({ type: z.literal("done") });
 export const sdkAgentStreamEventSchema = z.discriminatedUnion("type", [
-    z.object({ type: z.literal("run_started"), runId: z.string() }),
-    z.object({ type: z.literal("text"), text: z.string() }),
-    z.object({ type: z.literal("final_output"), finalOutput: z.string() }),
-    z.object({ type: z.literal("tool_call_params"), toolCallParams: z.string() }),
-    z.object({ type: z.literal("tool_call_started"), toolCallStarted: z.string() }),
-    z.object({ type: z.literal("tool_call_completed"), toolCallCompleted: z.string() }),
-    z.object({
-        type: z.literal("tool_approval_requested"),
-        toolApprovalRequested: toolApprovalRequestedPayloadSchema
-    }),
-    z.object({ type: z.literal("action"), action: runHistoryActionBaseSchema }),
-    z.object({ type: z.literal("error"), message: z.string() }),
-    z.object({ type: z.literal("done") })
+    runStartedSchema,
+    textSchema,
+    finalOutputSchema,
+    toolCallParamsSchema,
+    toolCallStartedSchema,
+    toolCallCompletedSchema,
+    toolApprovalRequestedSchema,
+    actionSchema,
+    errorSchema,
+    doneSchema
 ]);
 export const sdkApprovalDecisionRequestBodySchema = z.object({
     runId: z.string(),
@@ -644,19 +460,35 @@ export const sdkApprovalDecisionRequestBodySchema = z.object({
 });
 export const sdkDeployJobSchema = z.object({
     jobName: z.string(),
-    triggers: z.array(configDataSchema),
-    outputs: z.array(configDataSchema),
-    toolApprovals: z.array(z.string()),
-    webhookURL: z.string().optional()
+    triggers: z.array(triggerConfigDataSchema),
+    outputs: z.array(skillConfigDataSchema),
+    toolApprovals: z.array(z.string())
 });
-export const sdkDeployRequestBodySchema = z.object({
+export const sdkDeployRequestBodySchema = z
+    .object({
     jobs: z.array(sdkDeployJobSchema),
-    sourceZipBase64: z.string()
+    remoteServerUrl: z.string().optional(),
+    sourceZipBase64: z.string().optional()
+})
+    .refine(data => !(data.remoteServerUrl && data.sourceZipBase64), {
+    message: "remoteServerUrl and sourceZipBase64 cannot be provided together",
+    path: ["remoteServerUrl"]
+})
+    .refine(data => data.remoteServerUrl != null || data.sourceZipBase64 != null, {
+    message: "Either remoteServerUrl or sourceZipBase64 is required",
+    path: ["sourceZipBase64"]
 });
 export const sdkDeployResultSchema = z.object({
     jobName: z.string(),
     automationId: z.string(),
-    isUpdate: z.boolean()
+    isUpdate: z.boolean(),
+    signingSecret: z.string().optional(),
+    triggers: z
+        .array(z.object({
+        id: z.string(),
+        metadata: triggerMetadataSchema.optional()
+    }))
+        .optional()
 });
 export const sdkDeployRemovedSchema = z.object({
     id: z.string(),
@@ -669,6 +501,14 @@ export const sdkDeployResponseBodySchema = z.object({
     error: z.string().optional(),
     details: z.string().optional()
 });
+export const sdkJobServerCheckStepSchema = z.enum(["http", "json", "response_schema", "challenge_echo", "challenge_signature"]);
+export const sdkJobServerCheckResponseSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    triggerUrl: z.string().optional(),
+    step: sdkJobServerCheckStepSchema.optional(),
+    httpStatus: z.number().optional()
+});
 // ─── Request / param schemas ─────────────────────────────────────────
 export const agentIdParamsSchema = z.object({
     agentId: z.string()
@@ -727,8 +567,55 @@ export const workosWebhookSecretUpdateRequestSchema = z.object({
     state: z.string().optional()
 });
 export const sdkSampleEventsRequestSchema = z.object({
-    triggers: z.array(triggerPayloadSchema).min(1)
+    triggers: z
+        .array(z.object({
+        integrationId: z.string(),
+        integrationType: integrationTypeEnum,
+        config: configDataSchema
+    }))
+        .min(1)
 });
 export const triggerWithEventRequestSchema = z.object({
+    event: TriggerSchema
+});
+export const TERSE_SIGNATURE_HEADER = "x-terse-signature";
+export const TERSE_TIMESTAMP_HEADER = "x-terse-timestamp";
+export const TERSE_SIGNATURE_VERSION = "v0";
+/** Challenge request sent by the Terse backend to the customer's SDK server. */
+export const webhookJobChallengeRequestSchema = z.object({
+    type: z.literal("challenge"),
+    challenge: z.string().min(1)
+});
+/** Challenge response from the customer's SDK server -- echoes the token and signs it with the shared signing secret. */
+export const webhookJobChallengeResponseSchema = z.object({
+    challenge: z.string().min(1),
+    signature: z.string().min(1)
+});
+/** Second-phase POST: full trigger payload after the backend has verified the challenge handshake. */
+export const webhookJobTriggerRequestSchema = z.object({
+    jobName: z.string(),
+    runId: z.string(),
     event: serializedEventSchema
 });
+export const webhookJobTriggerResponseSchema = z.object({
+    status: z.string().optional(),
+    filtered: z.boolean().optional()
+});
+const fileSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    get children() {
+        return z.array(fileSchema).optional();
+    }
+});
+export const agentFilesResponseSchema = z.object({
+    id: z.string(),
+    files: z.array(fileSchema)
+});
+/** Proxied SDK zip member: raw bytes as base64 plus path metadata (no separate GCS objects). */
+export const agentFileContentResponseSchema = z.object({
+    path: z.string(),
+    fileName: z.string(),
+    contentBase64: z.string(),
+    mimeType: z.string().optional()
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-types",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "Shared Terse TypeScript types, enums, constants, and helpers.",
   "main": "./dist/index.js",
@@ -34,6 +34,8 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
+    "@slack/types": "^2.20.1",
+    "@slack/web-api": "^7.15.0",
     "zod": "4.3.6"
   },
   "scripts": {