terse-cli 0.1.16 → 0.1.18

package/templates/typescript/codegen/partials/atlassian-section.hbs

@@ -0,0 +1,32 @@
+{{sectionHeader "Jira & Confluence"}}
+
+{{> resource-class jiraProjectClass}}
+
+{{> resource-class confluencePageClass}}
+
+export const Jira = {
+    /** Trigger when a Jira issue is created */
+    onIssueCreated(opts?: { project?: JiraProject }): JiraConfig {
+        return new JiraConfig("{{escape id}}", opts?.project?.projectKey, opts?.project?.projectId, [JiraEventType.ISSUE_CREATED])
+    },
+    /** Trigger when a Jira issue is updated */
+    onIssueUpdated(opts?: { project?: JiraProject }): JiraConfig {
+        return new JiraConfig("{{escape id}}", opts?.project?.projectKey, opts?.project?.projectId, [JiraEventType.ISSUE_UPDATED])
+    },
+    /** Trigger on all Jira events */
+    trigger(opts?: { project?: JiraProject; eventTypes?: JiraEventType[] }): JiraConfig {
+        return new JiraConfig("{{escape id}}", opts?.project?.projectKey, opts?.project?.projectId, opts?.eventTypes)
+    },
+    /** Use in `skills[]` */
+    skill(opts?: { project?: JiraProject }): TypedSkill<{{{skillToolType}}}> {
+        return new JiraConfig("{{escape id}}", opts?.project?.projectKey, opts?.project?.projectId) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+
+export const Confluence = {
+    /** Use in `skills[]` */
+    skill(opts: { page: ConfluencePage }): TypedSkill<{{{skillToolType}}}> {
+        return new ConfluenceConfig("{{escape id}}", opts.page.spaceName, opts.page.spaceId, opts.page.pageId, opts.page.title) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/attio-section.hbs

@@ -0,0 +1,38 @@
+{{sectionHeader "Attio"}}
+
+export type AttioAttributeDefinition<TSlug extends string = string, TType extends string = string> = {
+    apiSlug: TSlug
+    title?: string
+    type?: TType
+    isRequired?: boolean
+    isUnique?: boolean
+}
+
+export class AttioObject<
+    TSlug extends string = string,
+    TRecordValues extends Record<string, unknown> = Record<string, unknown>,
+    TInputValues extends Record<string, unknown> = TRecordValues
+> {
+    constructor(
+        public readonly apiSlug: TSlug,
+        public readonly name: string,
+        public readonly attributes: readonly AttioAttributeDefinition[] = []
+    ) {}
+
+    declare readonly __recordValues: TRecordValues
+    declare readonly __inputValues: TInputValues
+{{#if objects.length}}
+
+{{#each objects}}
+    static {{staticName}} = new AttioObject<"{{escape apiSlug}}", {{{recordValuesType}}}, {{{inputValuesType}}}>("{{escape apiSlug}}", "{{escape singularNoun}}", {{{attributeSource}}})
+{{/each}}
+{{/if}}
+}
+
+export const Attio = {
+    /** Use in `skills[]` */
+    skill(opts: { object: AttioObject<any> }): TypedSkill<{{{skillToolType}}}> {
+        return new AttioOutputConfig("{{escape id}}", opts.object.apiSlug) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/datadog-section.hbs

@@ -0,0 +1,11 @@
+{{sectionHeader "Datadog"}}
+
+{{> resource-class indexClass}}
+
+export const Datadog = {
+    /** Use in `skills[]` */
+    skill(opts?: { indexes?: DatadogIndex[] }): TypedSkill<{{{skillToolType}}}> {
+        return new DatadogConfig("{{escape id}}", opts?.indexes?.map(i => i.name)) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/figma-section.hbs

@@ -0,0 +1,13 @@
+{{sectionHeader "Figma"}}
+
+export const Figma = {
+    /** Trigger when a comment is added to a Figma file */
+    onComment(opts: { fileKey: string; fileName: string; teamId: string }): FigmaConfig {
+        return new FigmaConfig("{{escape id}}", opts.fileKey, opts.fileName, opts.teamId, [FigmaEventType.FILE_COMMENT])
+    },
+    /** Trigger on all Figma events */
+    trigger(opts: { fileKey: string; fileName: string; teamId: string; eventTypes?: FigmaEventType[] }): FigmaConfig {
+        return new FigmaConfig("{{escape id}}", opts.fileKey, opts.fileName, opts.teamId, opts.eventTypes)
+    },
+}
+

package/templates/typescript/codegen/partials/github-section.hbs

@@ -0,0 +1,62 @@
+{{sectionHeader "GitHub"}}
+
+export class GithubOwner {
+    constructor(public readonly name: string) {}
+{{#if owners.length}}
+
+{{#each owners}}
+    static {{staticName}} = new GithubOwner("{{escape name}}")
+{{/each}}
+{{/if}}
+}
+
+export class Repos {
+    constructor(
+        public readonly repositoryId: number,
+        public readonly name: string,
+        public readonly owner: GithubOwner,
+        public readonly fullName: string
+    ) {}
+{{#if repoGroups.length}}
+
+{{#each repoGroups}}
+    static {{ownerStaticName}} = {
+{{#each repos}}
+        {{staticName}}: new Repos({{id}}, "{{escape name}}", GithubOwner.{{../ownerStaticName}}, "{{escape fullName}}"),
+{{/each}}
+    } as const
+{{/each}}
+{{/if}}
+}
+
+export const GitHub = {
+    /** Trigger on push to a repository */
+    onPush(opts: { repo: Repos }): TypedTrigger<GithubPushInputEvent> {
+        return new GitHubConfig("{{escape id}}", [opts.repo.repositoryId], [GitHubEventType.PUSH]) as TypedTrigger<GithubPushInputEvent>
+    },
+    /** Trigger when a pull request is opened */
+    onPROpened(opts: { repo: Repos }): TypedTrigger<GithubPRInputEvent> {
+        return new GitHubConfig("{{escape id}}", [opts.repo.repositoryId], [GitHubEventType.PR_OPENED]) as TypedTrigger<GithubPRInputEvent>
+    },
+    /** Trigger when a pull request is merged */
+    onPRMerged(opts: { repo: Repos }): TypedTrigger<GithubPRInputEvent> {
+        return new GitHubConfig("{{escape id}}", [opts.repo.repositoryId], [GitHubEventType.PR_MERGED]) as TypedTrigger<GithubPRInputEvent>
+    },
+    /** Trigger when a pull request is closed */
+    onPRClosed(opts: { repo: Repos }): TypedTrigger<GithubPRInputEvent> {
+        return new GitHubConfig("{{escape id}}", [opts.repo.repositoryId], [GitHubEventType.PR_CLOSED]) as TypedTrigger<GithubPRInputEvent>
+    },
+    /** Trigger on any pull request event */
+    onPR(opts: { repo: Repos }): TypedTrigger<GithubPRInputEvent> {
+        return new GitHubConfig("{{escape id}}", [opts.repo.repositoryId], [GitHubEventType.PR_OPENED, GitHubEventType.PR_MERGED, GitHubEventType.PR_CLOSED, GitHubEventType.PR_SYNCHRONIZE]) as TypedTrigger<GithubPRInputEvent>
+    },
+    /** Trigger on specific GitHub events for the given repositories */
+    trigger(opts: { repos: Repos[]; eventTypes?: GitHubEventType[] }): TypedTrigger<GithubInputEvent> {
+        return new GitHubConfig("{{escape id}}", opts.repos.map(r => r.repositoryId), opts.eventTypes) as TypedTrigger<GithubInputEvent>
+    },
+    /** Use in `skills[]` */
+    skill(opts: { repos: Repos[] }): TypedSkill<{{{skillToolType}}}> {
+        return new GitHubConfig("{{escape id}}", opts.repos.map(r => r.repositoryId)) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/gmail-section.hbs

@@ -0,0 +1,21 @@
+{{sectionHeader "Gmail"}}
+
+export const Gmail = {
+    /** Trigger when a new email is received */
+    onEmail(): GmailConfig {
+        return new GmailConfig("{{escape id}}", [GmailEventType.EMAIL_RECEIVED])
+    },
+    /** Trigger on all Gmail events */
+    trigger(opts?: { eventTypes?: GmailEventType[] }): GmailConfig {
+        return new GmailConfig("{{escape id}}", opts?.eventTypes)
+    },
+    /** Use in `skills[]` */
+    skill(): TypedSkill<{{{skillToolType}}}> {
+        return new GmailOutputConfig("{{escape id}}") as TypedSkill<{{{skillToolType}}}>
+    },
+    /** Use in `skills[]` — creates draft emails */
+    draftSkill(): TypedSkill<{{{skillToolType}}}> {
+        return new GmailDraftOutputConfig("{{escape id}}") as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/header.hbs

@@ -0,0 +1,12 @@
+// Auto-generated by `terse generate` — do not edit manually
+// Re-run `terse generate` to update.
+
+{{#if useMultilineImports}}
+import {
+{{#each imports}}
+    {{this}},
+{{/each}}
+} from "terse-sdk"
+{{else}}
+import { {{#each imports}}{{this}}{{#unless @last}}, {{/unless}}{{/each}} } from "terse-sdk"
+{{/if}}

package/templates/typescript/codegen/partials/launchdarkly-section.hbs

@@ -0,0 +1,11 @@
+{{sectionHeader "LaunchDarkly"}}
+
+{{> resource-class projectClass}}
+
+export const LaunchDarkly = {
+    /** Use in `skills[]` */
+    skill(opts: { project: LaunchDarklyProject; environmentKeys: string[] }): TypedSkill<{{{skillToolType}}}> {
+        return new LaunchDarklyConfig("{{escape id}}", opts.project.projectKey, opts.environmentKeys) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/linear-section.hbs

@@ -0,0 +1,27 @@
+{{sectionHeader "Linear"}}
+
+{{> resource-class teamClass}}
+
+export const Linear = {
+    /** Trigger when a new issue is created */
+    onIssueCreated(opts?: { projectId?: string; projectName?: string }): LinearInputConfig {
+        return new LinearInputConfig("{{escape id}}", opts?.projectId, opts?.projectName, [LinearEventType.ISSUE_CREATED])
+    },
+    /** Trigger when an issue is updated */
+    onIssueUpdated(opts?: { projectId?: string; projectName?: string }): LinearInputConfig {
+        return new LinearInputConfig("{{escape id}}", opts?.projectId, opts?.projectName, [LinearEventType.ISSUE_UPDATED])
+    },
+    /** Trigger when a comment is added to an issue */
+    onComment(opts?: { projectId?: string; projectName?: string }): LinearInputConfig {
+        return new LinearInputConfig("{{escape id}}", opts?.projectId, opts?.projectName, [LinearEventType.COMMENT_CREATED])
+    },
+    /** Trigger on all Linear events */
+    trigger(opts?: { projectId?: string; projectName?: string; eventTypes?: LinearEventType[] }): LinearInputConfig {
+        return new LinearInputConfig("{{escape id}}", opts?.projectId, opts?.projectName, opts?.eventTypes)
+    },
+    /** Use in `skills[]` */
+    skill(opts?: { team?: LinearTeam; projectId?: string; projectName?: string }): TypedSkill<{{{skillToolType}}}> {
+        return new LinearOutputConfig("{{escape id}}", opts?.team?.teamId, opts?.team?.name, opts?.projectId, opts?.projectName) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/notion-section.hbs

@@ -0,0 +1,15 @@
+{{sectionHeader "Notion"}}
+
+{{> resource-class databaseClass}}
+
+{{> resource-class pageClass}}
+
+export const Notion = {
+    /** Use in `skills[]` */
+    skill(opts?: { databases?: NotionDatabase[]; pages?: NotionPage[] }): TypedSkill<{{{skillToolType}}}> {
+        return new NotionConfig("{{escape 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)) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/posthog-section.hbs

@@ -0,0 +1,11 @@
+{{sectionHeader "PostHog"}}
+
+{{> resource-class projectClass}}
+
+export const Posthog = {
+    /** Use in `skills[]` */
+    skill(opts: { project: PosthogProject }): TypedSkill<{{{skillToolType}}}> {
+        return new PosthogConfig("{{escape id}}", opts.project.projectId, opts.project.name) as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/resource-class.hbs

@@ -0,0 +1,9 @@
+export class {{className}} {
+    constructor({{{constructorParams}}}) {}
+{{#if items.length}}
+
+{{#each items}}
+    static {{staticName}} = new {{../className}}({{{argsText}}})
+{{/each}}
+{{/if}}
+}

package/templates/typescript/codegen/partials/slack-section.hbs

@@ -0,0 +1,22 @@
+{{sectionHeader "Slack"}}
+
+{{> resource-class channelClass}}
+
+export const Slack = {
+    /** Trigger on any message in a channel */
+    onMessage(opts: { channel: SlackChannel; userIds?: string[] }): TypedTrigger<SlackMessageEvent> {
+        return new SlackConfig("{{escape id}}", opts.channel.channelId, opts.channel.name, false, opts.userIds, [SlackEventType.MESSAGE])
+    },
+    /** Trigger on direct messages to the bot */
+    onDm(opts?: { userIds?: string[] }): TypedTrigger<SlackMessageEvent> {
+        return new SlackConfig("{{escape id}}", undefined, undefined, true, opts?.userIds, [SlackEventType.MESSAGE])
+    },
+    /** Trigger on all Slack events (messages + DMs) for a channel */
+    trigger(opts?: { channel?: SlackChannel; listenToUserDms?: boolean; userIds?: string[]; eventTypes?: SlackEventType[] }): TypedTrigger<SlackMessageEvent> {
+        return new SlackConfig("{{escape id}}", opts?.channel?.channelId, opts?.channel?.name, opts?.listenToUserDms, opts?.userIds, opts?.eventTypes)
+    },
+    /** Use in `skills[]` */
+    skill(opts: { channel: SlackChannel; userIds?: string[]; userNames?: string[]; listenToUserDms?: boolean }): TypedSkill<{{{skillToolType}}}> {
+        return new SlackOutputConfig("{{escape id}}", opts.channel.channelId ?? null, opts.channel.name ?? null, opts.userIds ?? null, opts.userNames ?? null, opts.listenToUserDms)
+    },
+}

package/templates/typescript/codegen/partials/snowflake-section.hbs

@@ -0,0 +1,9 @@
+{{sectionHeader "Snowflake"}}
+
+export const Snowflake = {
+    /** Use in `skills[]` */
+    skill(): TypedSkill<{{{skillToolType}}}> {
+        return new SnowflakeOutputConfig("{{escape id}}") as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/codegen/partials/system-section.hbs

@@ -0,0 +1,18 @@
+{{sectionHeader "Schedule"}}
+
+export const Schedule = {
+    /** Use in `triggers[]` — run on a cron schedule */
+    cron(opts: { expression: string }): TimeTriggerConfig {
+        return new TimeTriggerConfig(opts.expression)
+    },
+}
+
+{{sectionHeader "Terse"}}
+
+export const Terse = {
+    /** Use in `skills[]` — built-in web search */
+    skill(): TypedSkill<{{{skillToolType}}}> {
+        return new TerseConfig() as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

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

@@ -0,0 +1,69 @@
+{{sectionHeader "Typed Tools"}}
+
+{{#each attioPreludeLines}}
+{{{this}}}
+{{/each}}
+{{#each paramTypes}}
+{{#if description}}/** {{description}} */
+{{/if}}export type {{typeName}} = {{{tsType}}}
+
+{{/each}}
+{{#if githubRepoMappings.length}}
+const __githubRepoNameToFullName = new Map<string, string>([
+{{#each githubRepoMappings}}
+    ["{{escape name}}", "{{escape fullName}}"],
+{{/each}}
+])
+
+function __normalizeGitHubRepos(repo: unknown): string {
+    if (repo && typeof repo === "object" && "fullName" in (repo as Record<string, unknown>)) {
+        const fullName = (repo as { fullName?: unknown }).fullName
+        if (typeof fullName === "string" && fullName.length > 0) return fullName
+    }
+    if (typeof repo === "string") {
+        if (repo.includes("/")) return repo
+        return __githubRepoNameToFullName.get(repo) ?? repo
+    }
+    return String(repo ?? "")
+}
+
+function __normalizeGitHubReposNames(repositories: unknown): string[] {
+    if (!Array.isArray(repositories)) return []
+    return repositories.map(repo => __normalizeGitHubRepos(repo))
+}
+
+{{/if}}
+export type GeneratedTools = {
+{{#each groups}}
+    {{key}}: {
+{{#each methods}}
+{{#if description}}        /** {{description}} */
+{{/if}}        {{{generatedSignature}}}
+{{/each}}
+    }
+{{/each}}
+}
+
+declare module "terse-sdk" {
+    interface TerseAgent {
+        readonly tools: GeneratedTools
+    }
+}
+
+function createTools(agent: TerseAgent): GeneratedTools {
+    const manualToolConfigs = agent.manualToolConfigs ?? agent.skills
+    const allowed: Set<string> = new Set(manualToolConfigs.map(config => config.integrationType))
+    return {
+{{#each groups}}
+        ...(allowed.has("{{escape integrationType}}") ? { {{key}}: {
+{{#each methods}}
+{{#each runtimeLines}}
+            {{{this}}}
+{{/each}}
+{{/each}}
+        } } : {}),
+{{/each}}
+    } as GeneratedTools
+}
+
+;(globalThis as any).__terse_createTools = createTools

package/templates/typescript/codegen/partials/workos-section.hbs

@@ -0,0 +1,53 @@
+{{sectionHeader "WorkOS"}}
+
+export const WorkOS = {
+    /** Trigger on user creation */
+    onUserCreated(): TypedTrigger<WorkOSUserInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.USER_CREATED]) as TypedTrigger<WorkOSUserInputEvent>
+    },
+    /** Trigger on user update */
+    onUserUpdated(): TypedTrigger<WorkOSUserInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.USER_UPDATED]) as TypedTrigger<WorkOSUserInputEvent>
+    },
+    /** Trigger on user deletion */
+    onUserDeleted(): TypedTrigger<WorkOSUserInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.USER_DELETED]) as TypedTrigger<WorkOSUserInputEvent>
+    },
+    /** Trigger on organization membership change */
+    onMembershipChanged(): TypedTrigger<WorkOSMembershipInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.ORGANIZATION_MEMBERSHIP_CREATED, WorkOSEventType.ORGANIZATION_MEMBERSHIP_UPDATED, WorkOSEventType.ORGANIZATION_MEMBERSHIP_DELETED]) as TypedTrigger<WorkOSMembershipInputEvent>
+    },
+    /** Trigger when an invitation is sent */
+    onInvitationSent(): TypedTrigger<WorkOSInvitationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.INVITATION_CREATED, WorkOSEventType.INVITATION_RESENT]) as TypedTrigger<WorkOSInvitationInputEvent>
+    },
+    /** Trigger when an invitation is first created */
+    onInvitationCreated(): TypedTrigger<WorkOSInvitationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.INVITATION_CREATED]) as TypedTrigger<WorkOSInvitationInputEvent>
+    },
+    /** Trigger when an invitation is resent */
+    onInvitationResent(): TypedTrigger<WorkOSInvitationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.INVITATION_RESENT]) as TypedTrigger<WorkOSInvitationInputEvent>
+    },
+    /** Trigger on invitation accepted */
+    onInvitationAccepted(): TypedTrigger<WorkOSInvitationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.INVITATION_ACCEPTED]) as TypedTrigger<WorkOSInvitationInputEvent>
+    },
+    /** Trigger when an invitation is revoked */
+    onInvitationRevoked(): TypedTrigger<WorkOSInvitationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.INVITATION_REVOKED]) as TypedTrigger<WorkOSInvitationInputEvent>
+    },
+    /** Trigger on organization creation */
+    onOrganizationCreated(): TypedTrigger<WorkOSOrganizationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", [WorkOSEventType.ORGANIZATION_CREATED]) as TypedTrigger<WorkOSOrganizationInputEvent>
+    },
+    /** Trigger on specific WorkOS event types */
+    trigger(opts?: { eventTypes?: WorkOSEventType[] }): TypedTrigger<WorkOSInputEvent | WorkOSUserInputEvent | WorkOSMembershipInputEvent | WorkOSInvitationInputEvent | WorkOSOrganizationInputEvent> {
+        return new WorkOSInputConfig("{{escape id}}", opts?.eventTypes) as TypedTrigger<WorkOSInputEvent | WorkOSUserInputEvent | WorkOSMembershipInputEvent | WorkOSInvitationInputEvent | WorkOSOrganizationInputEvent>
+    },
+    /** Use in `skills[]` */
+    skill(): TypedSkill<{{{skillToolType}}}> {
+        return new WorkOSOutputConfig("{{escape id}}") as TypedSkill<{{{skillToolType}}}>
+    },
+}
+

package/templates/typescript/init/env.example.hbs

@@ -0,0 +1 @@
+TERSE_API_KEY=

package/templates/{package.json.tmpl → typescript/init/package.json.hbs}

@@ -1,5 +1,5 @@
 {
-  "name": "{{PROJECT_NAME}}",
+  "name": "{{projectName}}",
   "version": "0.1.0",
   "type": "module",
   "scripts": {

package/templates/{src/index.ts.tmpl → typescript/init/src/index.ts.hbs}

@@ -14,8 +14,6 @@ await client.createJob({
     const message = await Agent.tools.slack.sendMessage({
       channelId: SlackChannel.AllTerseInc.channelId,
       message: "New PR from " + event.sender.login + "!",
-      thread_ts: "",
-      blocks: "",
     });
 
     const prompt =
@@ -25,4 +23,4 @@ await client.createJob({
 
     await Agent.runAndWait(prompt);
   }
-});
+});