terse-cli 0.2.15 → 0.3.0

package/src/providers/typescript/modules/hey_reach/hey_reach.triggers.hbs

@@ -0,0 +1,56 @@
+{{sectionHeader "HeyReach triggers"}}
+
+{{#each triggerDeclarations}}
+{{{this}}}
+
+{{/each}}
+export const heyReachTriggers = {
+    /** Trigger when a connection request is sent */
+    onConnectionRequestSent(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachConnectionRequestSentTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.CONNECTION_REQUEST_SENT, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a connection request is accepted */
+    onConnectionRequestAccepted(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachConnectionRequestAcceptedTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.CONNECTION_REQUEST_ACCEPTED, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a LinkedIn message is sent */
+    onMessageSent(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachMessageSentTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.MESSAGE_SENT, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger on the first reply to a LinkedIn message */
+    onMessageReplyReceived(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachMessageReplyReceivedTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.MESSAGE_REPLY_RECEIVED, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when an InMail is sent */
+    onInmailSent(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachInmailSentTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.INMAIL_SENT, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger on the first reply to an InMail */
+    onInmailReplyReceived(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachInmailReplyReceivedTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.INMAIL_REPLY_RECEIVED, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a follow is sent */
+    onFollowSent(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachFollowSentTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.FOLLOW_SENT, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a post is liked */
+    onLikedPost(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachLikedPostTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.LIKED_POST, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a profile is viewed */
+    onViewedProfile(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachViewedProfileTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.VIEWED_PROFILE, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when a campaign completes */
+    onCampaignCompleted(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachCampaignCompletedTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.CAMPAIGN_COMPLETED, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger when lead tags are updated */
+    onLeadTagUpdated(opts?: { campaigns?: HeyReachCampaign[] }): TypedTrigger<HeyReachLeadTagUpdatedTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", HeyReachEventType.LEAD_TAG_UPDATED, (opts?.campaigns ?? []).map(c => c.campaignId))
+    },
+    /** Trigger on specific HeyReach event types */
+    trigger(opts: { campaigns?: HeyReachCampaign[]; eventType: HeyReachEventType }): TypedTrigger<HeyReachTrigger> {
+        return new HeyReachInputConfig("{{escape section.id}}", opts.eventType, (opts.campaigns ?? []).map(c => c.campaignId))
+    },
+}

package/src/providers/typescript/modules/launchdarkly/launchdarkly.tools.hbs

@@ -0,0 +1,16 @@
+{{sectionHeader "LaunchDarkly resources"}}
+
+{{> resource-class section.projectClass}}
+
+{{#if toolFile}}
+{{sectionHeader "LaunchDarkly tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "LaunchDarkly skill"}}
+
+/** LaunchDarkly — read and toggle feature flags in a project + environments */
+export function launchDarklySkill(opts: { project: LaunchDarklyProject; environmentKeys: string[] }): TypedSkill<{{{section.skillToolType}}}> {
+    return new LaunchDarklyConfig("{{escape section.id}}", opts.project.projectKey, opts.environmentKeys)
+}

package/src/providers/typescript/modules/linear/linear.tools.hbs

@@ -0,0 +1,23 @@
+{{sectionHeader "Linear resources"}}
+
+{{> resource-class section.teamClass}}
+
+{{> resource-class section.projectClass}}
+
+{{#if toolFile}}
+{{sectionHeader "Linear tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Linear skill"}}
+
+/** Linear — read and write issues, optionally scoped to a team or project */
+export function linearSkill(opts?: { team?: LinearTeam; project?: LinearProject }): TypedSkill<{{{section.skillToolType}}}> {
+    return new LinearOutputConfig(
+        "{{escape section.id}}",
+        opts?.team?.teamId ?? null,
+        opts?.team?.name ?? null,
+        opts?.project?.projectId ?? null
+    )
+}

package/src/providers/typescript/modules/linear/linear.triggers.hbs

@@ -0,0 +1,24 @@
+{{sectionHeader "Linear triggers"}}
+
+{{#each triggerDeclarations}}
+{{{this}}}
+
+{{/each}}
+export const linearTriggers = {
+    /** Trigger when a new issue is created. Optionally scope with `LinearTeam.*` / `LinearProject.*`. */
+    onIssueCreated(opts?: { team?: LinearTeam; project?: LinearProject }): TypedTrigger<LinearIssueCreatedTrigger> {
+        return new LinearInputConfig("{{escape section.id}}", opts?.project?.projectId ?? null, [LinearEventType.ISSUE_CREATED], opts?.team?.teamId ?? null)
+    },
+    /** Trigger when an issue is updated */
+    onIssueUpdated(opts?: { team?: LinearTeam; project?: LinearProject }): TypedTrigger<LinearIssueUpdatedTrigger> {
+        return new LinearInputConfig("{{escape section.id}}", opts?.project?.projectId ?? null, [LinearEventType.ISSUE_UPDATED], opts?.team?.teamId ?? null)
+    },
+    /** Trigger when a comment is added to an issue */
+    onComment(opts?: { team?: LinearTeam; project?: LinearProject }): TypedTrigger<LinearCommentCreatedTrigger> {
+        return new LinearInputConfig("{{escape section.id}}", opts?.project?.projectId ?? null, [LinearEventType.COMMENT_CREATED], opts?.team?.teamId ?? null)
+    },
+    /** Trigger on all Linear events */
+    trigger(opts?: { team?: LinearTeam; project?: LinearProject; eventTypes?: LinearEventType[] }): TypedTrigger<LinearTrigger> {
+        return new LinearInputConfig("{{escape section.id}}", opts?.project?.projectId ?? null, opts?.eventTypes, opts?.team?.teamId ?? null)
+    },
+}

package/src/providers/typescript/modules/notion/notion.tools.hbs

@@ -0,0 +1,20 @@
+{{sectionHeader "Notion resources"}}
+
+{{> resource-class section.databaseClass}}
+
+{{> resource-class section.pageClass}}
+
+{{#if toolFile}}
+{{sectionHeader "Notion tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Notion skill"}}
+
+/** Notion — read and write to the given databases or pages */
+export function notionSkill(opts?: { databases?: NotionDatabase[]; pages?: NotionPage[] }): TypedSkill<{{{section.skillToolType}}}> {
+    return new NotionConfig("{{escape section.id}}",
+        opts?.databases?.map(d => d.databaseId), opts?.databases?.map(d => d.title),
+        opts?.pages?.map(p => p.pageId), opts?.pages?.map(p => p.title))
+}

package/src/providers/typescript/modules/posthog/posthog.tools.hbs

@@ -0,0 +1,28 @@
+{{sectionHeader "PostHog resources"}}
+
+{{> resource-class section.projectClass}}
+
+{{#if section.eventNames.length}}
+/**
+ * Custom event names observed in your PostHog project over the last 180 days.
+ * Built-in $-prefixed events (e.g. "$pageview") are always accepted alongside these.
+ * Terse supports US PostHog Cloud (us.posthog.com) only; EU-hosted PostHog is not supported.
+ */
+export type PosthogEventName =
+{{#each section.eventNames}}
+    | "{{escape this}}"
+{{/each}}
+
+{{/if}}
+{{#if toolFile}}
+{{sectionHeader "PostHog tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "PostHog skill"}}
+
+/** PostHog — query analytics for a specific project */
+export function posthogSkill(opts: { project: PosthogProject }): TypedSkill<{{{section.skillToolType}}}> {
+    return new PosthogConfig("{{escape section.id}}", opts.project.projectId, opts.project.name)
+}

package/src/providers/typescript/modules/resend/resend.tools.hbs

@@ -0,0 +1,46 @@
+{{sectionHeader "Resend templates"}}
+
+export type ResendTemplateVariableValue = string | number
+
+export interface GeneratedResendTemplate {
+    readonly templateId: string
+    readonly alias: string | null
+    readonly name: string
+    readonly variables: readonly { key: string; type: "string" | "number"; required: boolean; fallbackValue: ResendTemplateVariableValue | null }[]
+}
+
+export const ResendTemplates = {
+{{#each section.templates}}
+    {{staticName}}: {
+        templateId: "{{escape id}}",
+        alias: {{#if alias}}"{{escape alias}}"{{else}}null{{/if}},
+        name: "{{escape name}}",
+        variables: [{{{variablesMetadata}}}],
+    },
+{{/each}}
+} as const satisfies Record<string, GeneratedResendTemplate>
+
+export type ResendTemplate = (typeof ResendTemplates)[keyof typeof ResendTemplates]
+{{#if section.templates.length}}
+
+{{{section.baseParamsDeclaration}}}
+
+/** Send a published Resend email template. `variables` is typed per template, keyed by `templateId`. */
+export type ResendSendTemplateParams =
+{{#each section.templates}}
+    | (ResendSendTemplateBaseParams & { templateId: typeof ResendTemplates.{{staticName}}.templateId; variables: {{{variablesType}}} })
+{{/each}}
+
+{{/if}}
+{{#if toolFile}}
+{{sectionHeader "Resend tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Resend skill"}}
+
+/** Resend — send transactional email using generated published templates */
+export function resendSkill(): TypedSkill<{{{section.skillToolType}}}> {
+    return new ResendOutputConfig("{{escape section.id}}")
+}

package/src/providers/typescript/modules/slack/slack.tools.hbs

@@ -0,0 +1,18 @@
+{{sectionHeader "Slack resources"}}
+
+{{> resource-class section.channelClass}}
+
+{{> resource-class section.userClass}}
+
+{{#if toolFile}}
+{{sectionHeader "Slack tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Slack skill"}}
+
+/** Slack — send messages and manage threads in a specific channel */
+export function slackSkill(opts: { channel: SlackChannel; userIds?: string[]; userNames?: string[]; listenToUserDms?: boolean }): TypedSkill<{{{section.skillToolType}}}> {
+    return new SlackOutputConfig("{{escape section.id}}", opts.channel.channelId ?? null, opts.channel.name ?? null, opts.userIds ?? [], opts.userNames ?? null, opts.listenToUserDms)
+}

package/src/providers/typescript/modules/slack/slack.triggers.hbs

@@ -0,0 +1,28 @@
+{{sectionHeader "Slack triggers"}}
+
+{{#each triggerDeclarations}}
+{{{this}}}
+
+{{/each}}
+export const slackTriggers = {
+    /** Trigger on any message in a channel */
+    onMessage(opts: { channel: SlackChannel; userIds?: string[] }): TypedTrigger<SlackMessageTrigger> {
+        return new SlackConfig("{{escape section.id}}", opts.channel.channelId, opts.channel.name, false, opts.userIds ?? [], [SlackEventType.MESSAGE])
+    },
+    /** Trigger on direct messages to the bot */
+    onDm(opts?: { userIds?: string[] }): TypedTrigger<SlackMessageTrigger> {
+        return new SlackConfig("{{escape section.id}}", undefined, undefined, true, opts?.userIds ?? [], [SlackEventType.MESSAGE])
+    },
+    /** Trigger when the Slack app is directly mentioned */
+    onAppMention(opts: { channel: SlackChannel; userIds?: string[] }): TypedTrigger<SlackAppMentionTrigger> {
+        return new SlackConfig("{{escape section.id}}", opts.channel.channelId, opts.channel.name, false, opts.userIds ?? [], [SlackEventType.APP_MENTION])
+    },
+    /** Trigger when a reaction is added to a message in a channel */
+    onReactionAdded(opts: { channel: SlackChannel; userIds?: string[] }): TypedTrigger<SlackReactionAddedTrigger> {
+        return new SlackConfig("{{escape section.id}}", opts.channel.channelId, opts.channel.name, false, opts.userIds ?? [], [SlackEventType.REACTION_ADDED])
+    },
+    /** Trigger on all Slack events (messages + DMs) for a channel */
+    trigger(opts?: { channel?: SlackChannel; listenToUserDms?: boolean; userIds?: string[]; eventTypes?: SlackEventType[] }): TypedTrigger<SlackTrigger> {
+        return new SlackConfig("{{escape section.id}}", opts?.channel?.channelId, opts?.channel?.name, opts?.listenToUserDms, opts?.userIds ?? [], opts?.eventTypes)
+    },
+}

package/src/providers/typescript/modules/snowflake/snowflake.tools.hbs

@@ -0,0 +1,12 @@
+{{#if toolFile}}
+{{sectionHeader "Snowflake tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Snowflake skill"}}
+
+/** Snowflake — run SQL queries against your warehouse */
+export function snowflakeSkill(): TypedSkill<{{{section.skillToolType}}}> {
+    return new SnowflakeOutputConfig("{{escape section.id}}")
+}

package/src/providers/typescript/modules/terse/terse.tools.hbs

@@ -0,0 +1,22 @@
+{{#if toolFile}}
+{{sectionHeader "Terse built-in tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "Built-in skills"}}
+
+/** Web — built-in web search, page extraction, and multi-source research. Pass `allowedDomains` to restrict search and page extraction to specific sites (and their subdomains). */
+export function webSkill(opts: { allowedDomains?: string[] } = {}): TypedSkill<"web_search" | "web_extract" | "web_research"> {
+    return new WebConfig(opts)
+}
+
+/** ImageEdit — edit and generate images */
+export function imageEditSkill(): TypedSkill<"image_edit"> {
+    return new ImageEditConfig()
+}
+
+/** Memory — built-in persistent memory the agent reads and writes under /memories, scoped to this job and surviving across runs. */
+export function memorySkill(): TypedSkill<"memory"> {
+    return new MemoryConfig()
+}

package/src/providers/typescript/modules/terse/terse.triggers.hbs

@@ -0,0 +1,33 @@
+{{sectionHeader "Built-in triggers"}}
+
+{{#each triggerDeclarations}}
+{{{this}}}
+
+{{/each}}
+export const scheduleTriggers = {
+    /** Run on a cron schedule (5-field cron expression, evaluated in UTC) */
+    cron(opts: { expression: string }): TypedTrigger<CronTrigger> {
+        return new TimeTriggerConfig(opts.expression)
+    },
+}
+
+export const webhookTriggers = {
+    /** Trigger via an external HTTP request to a generated URL */
+    onRequest<TBody = unknown>(): TypedTrigger<WebhookTrigger<TBody>> {
+        return new WebhookInputConfig()
+    },
+}
+
+/** Bind a web-monitor event to a Zod schema: the `payload` field types as the schema's output */
+export type WebMonitorTriggerFor<TSchema> = WebMonitorTrigger<InferStructuredOutput<TSchema>>
+
+export const webMonitorTriggers = {
+    /** Trigger when a query against the live web matches the given schema */
+    onEvent<const TSchema>(opts: {
+        query: string
+        frequency: { number: number; unit: FrequencyUnit }
+        outputSchema?: TSchema
+    }): TypedTrigger<WebMonitorTrigger<InferStructuredOutput<TSchema>>> {
+        return new WebMonitorConfig(opts.query, opts.frequency, opts.outputSchema)
+    },
+}

package/src/providers/typescript/modules/workos/workos.tools.hbs

@@ -0,0 +1,12 @@
+{{#if toolFile}}
+{{sectionHeader "WorkOS tools"}}
+
+{{> tools-slice toolFile}}
+
+{{/if}}
+{{sectionHeader "WorkOS skill"}}
+
+/** WorkOS — manage users, organizations and invitations */
+export function workOSSkill(): TypedSkill<{{{section.skillToolType}}}> {
+    return new WorkOSOutputConfig("{{escape section.id}}")
+}

package/src/providers/typescript/modules/workos/workos.triggers.hbs

@@ -0,0 +1,64 @@
+{{sectionHeader "WorkOS triggers"}}
+
+{{#each triggerDeclarations}}
+{{{this}}}
+
+{{/each}}
+export const workOSTriggers = {
+    /** Trigger on user creation */
+    onUserCreated(): TypedTrigger<WorkOSUserCreatedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.USER_CREATED])
+    },
+    /** Trigger on user update */
+    onUserUpdated(): TypedTrigger<WorkOSUserUpdatedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.USER_UPDATED])
+    },
+    /** Trigger on user deletion */
+    onUserDeleted(): TypedTrigger<WorkOSUserDeletedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.USER_DELETED])
+    },
+    /** Trigger on organization membership creation */
+    onMembershipCreated(): TypedTrigger<WorkOSOrganizationMembershipCreatedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.ORGANIZATION_MEMBERSHIP_CREATED])
+    },
+    /** Trigger on organization membership update */
+    onMembershipUpdated(): TypedTrigger<WorkOSOrganizationMembershipUpdatedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.ORGANIZATION_MEMBERSHIP_UPDATED])
+    },
+    /** Trigger on organization membership deletion */
+    onMembershipDeleted(): TypedTrigger<WorkOSOrganizationMembershipDeletedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.ORGANIZATION_MEMBERSHIP_DELETED])
+    },
+    /** Trigger on any organization membership change */
+    onMembershipChanged(): TypedTrigger<WorkOSMembershipTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.ORGANIZATION_MEMBERSHIP_CREATED, WorkOSEventType.ORGANIZATION_MEMBERSHIP_UPDATED, WorkOSEventType.ORGANIZATION_MEMBERSHIP_DELETED])
+    },
+    /** Trigger when an invitation is sent (created or resent) */
+    onInvitationSent(): TypedTrigger<WorkOSInvitationTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.INVITATION_CREATED, WorkOSEventType.INVITATION_RESENT])
+    },
+    /** Trigger when an invitation is first created */
+    onInvitationCreated(): TypedTrigger<WorkOSInvitationCreatedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.INVITATION_CREATED])
+    },
+    /** Trigger when an invitation is resent */
+    onInvitationResent(): TypedTrigger<WorkOSInvitationResentTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.INVITATION_RESENT])
+    },
+    /** Trigger on invitation accepted */
+    onInvitationAccepted(): TypedTrigger<WorkOSInvitationAcceptedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.INVITATION_ACCEPTED])
+    },
+    /** Trigger when an invitation is revoked */
+    onInvitationRevoked(): TypedTrigger<WorkOSInvitationRevokedTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.INVITATION_REVOKED])
+    },
+    /** Trigger on organization creation */
+    onOrganizationCreated(): TypedTrigger<WorkOSOrganizationTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", [WorkOSEventType.ORGANIZATION_CREATED])
+    },
+    /** Trigger on specific WorkOS event types */
+    trigger(opts?: { eventTypes?: WorkOSEventType[] }): TypedTrigger<WorkOSTrigger | WorkOSUserTrigger | WorkOSMembershipTrigger | WorkOSInvitationTrigger | WorkOSOrganizationTrigger> {
+        return new WorkOSInputConfig("{{escape section.id}}", opts?.eventTypes)
+    },
+}

package/templates/typescript/codegen/.impeccable/hook.cache.json

@@ -1 +1 @@
-{"version":1,"sessions":{"9819a905-dfd0-4796-9ebb-35ebffe9e823":{"updatedAt":1783680440916,"files":{"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/providers/typescript/templateEngine.ts":{"editCount":1,"findings":[]},"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/providers/typescript/prepareCodegenData.ts":{"editCount":2,"findings":[]}}}}}
+{"version":1,"sessions":{"9819a905-dfd0-4796-9ebb-35ebffe9e823":{"updatedAt":1783680440916,"files":{"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/providers/typescript/templateEngine.ts":{"editCount":1,"findings":[]},"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/providers/typescript/prepareCodegenData.ts":{"editCount":2,"findings":[]}}},"880affde-d725-41e0-945d-5d13f7843af7":{"updatedAt":1783982109807,"files":{"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/providers/typescript/templateEngine.ts":{"editCount":1,"findings":[]},"/Users/olimorissette/Desktop/projects/Terse/packages/terse-cli/src/commands/generate.ts":{"editCount":2,"findings":[]}}}}}

package/templates/typescript/codegen/common.hbs

@@ -0,0 +1,6 @@
+{{sectionHeader "Shared types"}}
+
+{{#each commonToolDeclarations}}
+{{{this}}}
+
+{{/each}}

package/templates/typescript/codegen/partials/tools-slice.hbs

@@ -0,0 +1,18 @@
+{{#each declarations}}
+{{{this}}}
+
+{{/each}}
+export type {{typeName}} = {
+{{#each methods}}
+{{#if description}}    /** {{description}} */
+{{/if}}    {{{generatedSignature}}}
+{{/each}}
+}
+
+export const {{constName}}: {{typeName}} = {
+{{#each methods}}
+{{#each runtimeLines}}
+    {{{this}}}
+{{/each}}
+{{/each}}
+}

package/templates/typescript/codegen/root.hbs

@@ -0,0 +1,72 @@
+{{sectionHeader "Triggers"}}
+
+/**
+ * Triggers available in your workspace.
+ *
+ * Type `Triggers.` in your editor to see every connected integration with triggers.
+ * Use these in `createJob({ triggers: [...] })`.
+ */
+export const Triggers = {
+{{#each triggersAggregateLines}}
+{{{this}}}
+{{/each}}
+}
+
+{{sectionHeader "Skills"}}
+
+/**
+ * Skills available in your workspace.
+ *
+ * Type `Skills.` in your editor to see every connected integration's skill at a glance.
+ * Use these in `generateText({ skills: [...] })` (or `TerseAgent.create({ skills: [...] })`).
+ */
+export const Skills = {
+{{#each skillsAggregateLines}}
+{{{this}}}
+{{/each}}
+}
+
+{{sectionHeader "Typed Tools"}}
+
+export type GeneratedTools = {
+{{#each toolboxEntries}}
+    {{key}}: {{typeName}}
+{{/each}}
+}
+
+declare module "terse-sdk" {
+    interface TerseAgent {
+        readonly tools: GeneratedTools
+    }
+}
+
+function createTools(agent: TerseAgent): GeneratedTools {
+    const allowed: Set<string> = new Set(agent.skills.map(config => config.integrationType))
+    return {
+{{#each toolboxEntries}}
+        ...(allowed.has("{{escape integrationType}}") ? { {{key}}: {{constName}} } : {}),
+{{/each}}
+    } as GeneratedTools
+}
+
+;(globalThis as any).__terse_createTools = createTools
+
+/**
+ * Deterministic tool calls without an agent.
+ *
+ * `toolbox` exposes every connected integration tool as a typed function. Unlike
+ * `agent.tools`, it does not require constructing a `TerseAgent` and is not
+ * filtered by `skills`. Use it when you know exactly which tool to call and
+ * don't need an LLM in the loop.
+ *
+ * @example
+ * ```ts
+ * import { toolbox } from "./terse.generated"
+ * await toolbox.slack.sendMessage({ channelId: "...", message: "hi" })
+ * ```
+ */
+export const toolbox: GeneratedTools = {
+{{#each toolboxEntries}}
+    {{key}}: {{constName}},
+{{/each}}
+}

package/templates/typescript/codegen/sdk-primitives.hbs

@@ -0,0 +1,42 @@
+// ── Platform primitives (from "terse-sdk") ────────────────────
+//
+// Everything below ships with the terse-sdk package. This summary is the
+// reference for job code — do not read the terse-sdk dist to rediscover it.
+//
+// Defining jobs:
+//   createJob({ name, triggers: [...], states?, filter?, onTrigger, durable? })
+//     Registers a workflow. `filter` and `onTrigger` receive (event, state);
+//     `filter` returns boolean to decide whether the run proceeds.
+//   Every trigger event has event.formatForAgentRunner(): string — the
+//     canonical way to inline the triggering event into an agent prompt.
+//
+// Agentic execution:
+//   generateText({ prompt, skills: [...], toolApprovals?, outputSchema? })
+//     One-shot agent run. Returns Promise<string>, or Promise<z.infer<schema>>
+//     when `outputSchema` (a zod schema) is given. Skills come from the
+//     generated `Skills` export below; the agent can only touch integrations
+//     whose skills are passed.
+//   TerseAgent.create({ prompt, skills, toolApprovals? })
+//     Streaming variant: `for await (const result of agent.run(message))`.
+//     `agent.tools` is typed to the generated tools of the passed skills.
+//
+// Per-job state (typed key/value store):
+//   states: [{ key: "runCount", value: z.number().default(0) }]
+//   then `await state.get("runCount")` / `await state.set("runCount", n)`
+//   in `filter`/`onTrigger`. Keys and value types come from the declaration.
+//
+// Durability (all of these require `durable: true` on the job):
+//   step(client.method(args))   Journals a single wrapped call; arguments and
+//                               result must be serializable.
+//   jobStep({ run, input?, inputSchema?, outputSchema? })
+//                               Journals a code block as one step.
+//   sleep("2h" | ms | Date)     Suspends the run; resumes after the duration.
+//   await log(...args)          Replay-safe console.log (prints exactly once).
+//   waitForInput({ via: slack({ channel: SlackChannel.X.channelId }), prompt, options })
+//                               Suspends until a human answers; resolves to
+//                               { choice, text?, respondent }. `options` is
+//                               [{ id, label, description?, freeText? }].
+//
+// Secrets:
+//   Write with `terse secrets add`; read in job code via process.env.MY_SECRET.
+//   There is no value-returning secrets API — env vars are the read side.

package/templates/typescript/codegen/generated.hbs

@@ -1,14 +0,0 @@
-{{> header}}
-
-{{#if github}}{{> github-section github}}{{/if~}}
-{{#if slack}}{{> slack-section slack}}{{/if~}}
-{{#if linear}}{{> linear-section linear}}{{/if~}}
-{{#if notion}}{{> notion-section notion}}{{/if~}}
-{{#if posthog}}{{> posthog-section posthog}}{{/if~}}
-{{#if datadog}}{{> datadog-section datadog}}{{/if~}}
-{{#if launchdarkly}}{{> launchdarkly-section launchdarkly}}{{/if~}}
-{{#if attio}}{{> attio-section attio}}{{/if~}}
-{{#if heyreach}}{{> hey-reach-section heyreach}}{{/if~}}
-{{> triggers-section}}
-{{> skills-section}}
-{{#if tools}}{{> tools-section tools}}{{/if}}