terse-types 0.0.20 → 0.0.22

package/dist/types.js

@@ -410,7 +410,8 @@ export const sdkAgentRunRequestBodySchema = z.object({
     message: z.string(),
     skills: z.array(skillConfigDataSchema).optional(),
     options: sdkAgentRunOptionsPayloadSchema.optional(),
-    toolApprovals: z.array(z.string()).optional()
+    toolApprovals: z.array(z.string()).optional(),
+    outputSchema: z.record(z.string(), z.unknown()).optional()
 });
 export const sdkAgentRunResponseContractSchema = z.object({
     responseMode: z.literal("streaming"),
@@ -622,6 +623,25 @@ export const sdkSampleEventsRequestSchema = z.object({
     }))
         .min(1)
 });
+export const hydratorTypeEnum = z.enum(["run_history_raw_event", "slack_message_event", "github_event", "linear_event", "gmail_event", "workos_event", "webmonitor_event"]);
+export const identifiableSchema = z.object({
+    entityType: hydratorTypeEnum,
+    entityId: z.string()
+});
+export const sdkSampleEventRefSchema = z.object({
+    entity: identifiableSchema,
+    serializedEvent: serializedEventSchema
+});
+export const sdkSampleEventsResponseSchema = z.object({
+    events: z.array(sdkSampleEventRefSchema)
+});
+export const sdkHydrateSampleEventRequestSchema = z.object({
+    entityType: z.string(),
+    entityId: z.string()
+});
+export const sdkHydrateSampleEventResponseSchema = z.object({
+    event: serializedEventSchema
+});
 export const triggerWithEventRequestSchema = z.union([
     z.object({
         event: TriggerSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-types",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "type": "module",
   "description": "Shared Terse TypeScript types, enums, constants, and helpers.",
   "main": "./dist/index.js",

package/dist/SandboxTypes.d.ts

@@ -1,15 +0,0 @@
-export type SandboxLogEntry = {
-    stream: "stdout" | "stderr";
-    text: string;
-    timestamp: number;
-};
-export type SandboxLogPayload = SandboxLogEntry & {
-    runId: string;
-    agentId: string;
-};
-export type SandboxLogsResponse = {
-    sandboxId: string | null;
-    entries: SandboxLogEntry[];
-    timestamp: number;
-    error?: string;
-};

package/dist/SandboxTypes.js

@@ -1 +0,0 @@
-export {};

package/dist/TriggerEventPresenters.d.ts

@@ -1,3 +0,0 @@
-import type { Trigger } from "./Triggers.js";
-export declare function formatTriggerForAgent(event: Trigger): string;
-export declare function debugTrigger(event: Trigger): string;

package/dist/TriggerEventPresenters.js

@@ -1,238 +0,0 @@
-import { IntegrationType } from "./Integrations.js";
-const TriggerPresenters = {
-    manual_sample: {
-        formatForAgent: (event) => `Manual sample event for ${event.integrationType}.`,
-        debug: (event) => `${event.integrationType} ${event.eventType}`
-    },
-    [IntegrationType.GITHUB]: {
-        formatForAgent: formatGithubTrigger,
-        debug: (event) => `GitHub Event: ${event.eventType} - ${event.repository.owner}/${event.repository.name} - ${event.sender.login}`
-    },
-    [IntegrationType.SLACK]: {
-        formatForAgent: formatSlackTrigger,
-        debug: (event) => {
-            const isDM = event.channelType === "im";
-            return `Slack Event: ${event.eventType} - ${isDM ? "DM" : event.channelName || event.channelId} - ${event.userName || event.userId}`;
-        }
-    },
-    [IntegrationType.GMAIL]: {
-        formatForAgent: formatGmailTrigger,
-        debug: (event) => `Gmail Event: ${event.subject} message ID: ${event.messageId}`
-    },
-    [IntegrationType.LINEAR]: {
-        formatForAgent: formatLinearTrigger,
-        debug: (event) => {
-            if (event.type === "Issue") {
-                return `Linear ${event.type} Event: ${event.data.identifier} - ${event.data.title} (${event.action})`;
-            }
-            return `Linear ${event.type} Event: Comment on issue ${event.data.issueId || "Unknown"} (${event.action})`;
-        }
-    },
-    [IntegrationType.WORKOS]: {
-        formatForAgent: formatWorkOSTrigger,
-        debug: (event) => `WorkOS ${event.eventType}`
-    },
-    [IntegrationType.WEBHOOK]: {
-        formatForAgent: formatWebhookTrigger,
-        debug: (event) => `Webhook Trigger (${event.method})`
-    },
-    [IntegrationType.CRON_JOB]: {
-        formatForAgent: formatCronTrigger,
-        debug: (event) => (event.isManualTrigger ? "Manual Trigger" : "Scheduled Event")
-    }
-};
-export function formatTriggerForAgent(event) {
-    if (event.eventType === "manual_sample") {
-        return TriggerPresenters.manual_sample.formatForAgent(event);
-    }
-    const presenter = TriggerPresenters[event.integrationType];
-    return presenter.formatForAgent(event);
-}
-export function debugTrigger(event) {
-    if (event.eventType === "manual_sample") {
-        return TriggerPresenters.manual_sample.debug(event);
-    }
-    const presenter = TriggerPresenters[event.integrationType];
-    return presenter.debug(event);
-}
-function formatGithubTrigger(event) {
-    const indentMultiline = (text) => text
-        .split("\n")
-        .map(line => `        ${line}`)
-        .join("\n");
-    const eventTypeDescriptions = {
-        push: "Code Push Event",
-        "pull_request.opened": "Pull Request Opened",
-        "pull_request.synchronize": "Pull Request Updated (new commits added)",
-        "pull_request.closed": "Pull Request Closed",
-        "pull_request.merged": "Pull Request Merged"
-    };
-    const eventDescription = eventTypeDescriptions[event.eventType] || event.eventType;
-    const repoInfo = [
-        `Repository: ${event.repository.owner}/${event.repository.name}`,
-        `Repository ID: ${event.repository.id}`,
-        `Default Branch: ${event.repository.defaultBranch}`,
-        `View on GitHub: https://github.com/${event.repository.owner}/${event.repository.name}`
-    ].join("\n");
-    const senderInfo = [`Actor: ${event.sender.login}`, ...(event.sender.email ? [`Email: ${event.sender.email}`] : [])].join("\n");
-    const branchInfo = event.branch ? `Branch: ${event.branch}` : null;
-    let prInfo = "";
-    if (event.pullRequest) {
-        const pr = event.pullRequest;
-        const author = pr.author ?? pr.user;
-        const prLines = [
-            `Pull Request #${pr.number}: ${pr.title}`,
-            `State: ${pr.state}${pr.merged ? " (merged)" : ""}`,
-            `Author: ${author.login}${author.email ? ` (${author.email})` : ""}`,
-            `Head Branch: ${pr.head.ref} (${pr.head.sha.substring(0, 7)})`,
-            `Base Branch: ${pr.base.ref} (${pr.base.sha.substring(0, 7)})`,
-            `View PR: ${pr.url}`
-        ];
-        if (pr.body) {
-            prLines.push(`\nDescription:\n${indentMultiline(pr.body)}`);
-        }
-        prInfo = prLines.join("\n");
-    }
-    let commitsInfo = "";
-    if (event.commits.length > 0) {
-        const commitLines = [];
-        commitLines.push(`Commits (${event.commits.length}):`);
-        event.commits.forEach((commit, index) => {
-            const shortSha = commit.sha.substring(0, 7);
-            const commitUrl = `https://github.com/${event.repository.owner}/${event.repository.name}/commit/${commit.sha}`;
-            commitLines.push(`\n${index + 1}. Commit ${shortSha}: ${commit.message || commit.name || ""}`);
-            commitLines.push(`   URL: ${commitUrl}`);
-            if (commit.fileDiffs.length > 0) {
-                commitLines.push(`   Files Changed: ${commit.fileDiffs.length}`);
-                const fileList = commit.fileDiffs.map(f => `     - ${f.filename}`).join("\n");
-                commitLines.push(`   Files:\n${fileList}`);
-            }
-        });
-        commitsInfo = commitLines.join("\n");
-    }
-    return [
-        `Incoming GitHub Event: ${eventDescription}`,
-        `\nRepository Information:\n${indentMultiline(repoInfo)}`,
-        `\nActor Information:\n${indentMultiline(senderInfo)}`,
-        ...(branchInfo ? [`\nBranch Information:\n${indentMultiline(branchInfo)}`] : []),
-        ...(prInfo ? [`\nPull Request Information:\n${indentMultiline(prInfo)}`] : []),
-        ...(commitsInfo ? [`\n${commitsInfo}`] : [])
-    ].join("\n\n");
-}
-function formatSlackTrigger(event) {
-    const blockContent = JSON.stringify(event.blocks);
-    const attachmentContent = JSON.stringify(event.attachments);
-    const messageText = event.text || "(no plain text)";
-    const threadTs = event.threadTs ?? event.threadTimestamp ?? null;
-    const eventLabel = event.eventType === "app_mention" ? "Incoming Slack App Mention Event." : event.eventType === "reaction_added" ? "Incoming Slack Reaction Added Event." : "Incoming Slack Message Event.";
-    const reactionInfo = event.eventType === "reaction_added"
-        ? `Reaction: ${event.reaction || "unknown"}\n        Target Message Timestamp: ${event.itemTimestamp || "unknown"}\n        Target User: ${event.itemUserId || "unknown"}`
-        : "";
-    return `
-        ${eventLabel}
-
-        Slack Event:
-        Event Type: ${event.eventType}
-        Channel: ${event.channelName || event.channelId}
-        User: ${event.userName || event.userId}
-        Message: ${messageText}
-        Timestamp: ${event.timestamp}
-        ${threadTs ? `Thread: ${threadTs}` : ""}
-        Team ID: ${event.teamId}
-        ${reactionInfo}
-        ${blockContent
-        ? `
-        Rich Content (from blocks):
-        ${blockContent}`
-        : ""}
-        ${attachmentContent
-        ? `
-        Attachment Content:
-        ${attachmentContent}`
-        : ""}
-        `;
-}
-function formatGmailTrigger(event) {
-    const attachmentInfo = event.attachments?.map(attachment => `- ${attachment.filename} ${attachment.isInline ? "Inline" : "Attachment"} (${attachment.mimeType})`).join("\n") || "No attachments";
-    return `
-        Incoming Email Event.
-
-        Gmail Event:
-        Subject: ${event.subject}
-        From: ${event.from}
-        To: ${event.to}
-        Date: ${event.date}
-        Message ID: ${event.messageId}
-        Thread ID: ${event.threadId}
-        Body: ${event.body}
-        Snippet: ${event.snippet}
-        Attachments (if any listed, actual files should be added below):
-        ${attachmentInfo}
-        `;
-}
-function formatLinearTrigger(event) {
-    const indentMultiline = (text) => text
-        .split("\n")
-        .map(line => `        ${line}`)
-        .join("\n");
-    const sections = [];
-    sections.push(`Incoming Linear ${event.type} Event`);
-    sections.push(`Action: ${event.action}`);
-    sections.push(`Actor: ${event.actor.name} (${event.actor.email})`);
-    sections.push(`Created: ${event.createdAt}`);
-    if (event.type === "Issue" && event.data) {
-        const issue = event.data;
-        const issueSections = [];
-        issueSections.push(`Issue: ${issue.identifier} - ${issue.title}`);
-        if (issue.description)
-            issueSections.push(`Description:\n${indentMultiline(issue.description)}`);
-        issueSections.push(`Priority: ${issue.priorityLabel || issue.priority}`);
-        issueSections.push(`State: ${issue.state?.name || "Unknown"}`);
-        issueSections.push(`Team: ${issue.team?.name || "Unknown"}`);
-        if (issue.assignee)
-            issueSections.push(`Assignee: ${issue.assignee.name}`);
-        if (issue.labels?.length)
-            issueSections.push(`Labels: ${issue.labels.map((label) => label.name || label).join(", ")}`);
-        if (issue.url)
-            issueSections.push(`URL: ${issue.url}`);
-        sections.push(issueSections.join("\n"));
-    }
-    else if (event.type === "Comment" && event.data) {
-        const commentSections = [`Comment on Issue: ${event.data.issueId || "Unknown"}`];
-        if (event.data.body)
-            commentSections.push(`Comment:\n${indentMultiline(event.data.body)}`);
-        sections.push(commentSections.join("\n"));
-    }
-    else {
-        sections.push(`Event Data:\n${indentMultiline(JSON.stringify(event.data, null, 2))}`);
-    }
-    if (event.organizationId) {
-        sections.push(`Organization ID: ${event.organizationId}`);
-    }
-    return sections.join("\n\n");
-}
-function formatWorkOSTrigger(event) {
-    const parts = [`WorkOS Event: ${event.eventType}`];
-    if ("user" in event && event.user) {
-        parts.push(`User Email: ${event.user.email}`);
-        if (event.user.firstName || event.user.lastName) {
-            parts.push(`User Name: ${[event.user.firstName, event.user.lastName].filter(Boolean).join(" ")}`);
-        }
-        parts.push(`User ID: ${event.user.id}`);
-    }
-    parts.push(`\nFull Event Data:\n${JSON.stringify(event, null, 2)}`);
-    return parts.join("\n");
-}
-function formatWebhookTrigger(event) {
-    return `Webhook request received.\n\nMethod: ${event.method}\n\nPayload:\n${JSON.stringify(event.body, null, 2)}`;
-}
-function formatCronTrigger(event) {
-    if (event.isManualTrigger) {
-        let message = `This is a manually triggered event for the channel input ${event.inputId}.`;
-        if (event.manualContext) {
-            message += `\n\nUser provided context for this manual trigger:\n${event.manualContext}`;
-        }
-        return message;
-    }
-    return `This is a scheduled event for the channel input ${event.inputId}. The channel input is configured to run at the following cron expression.`;
-}