terse-cli 0.2.15 → 0.3.0

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

@@ -1,86 +0,0 @@
-{{sectionHeader "Attio"}}
-
-{{#each valueTypeLines}}
-{{{this}}}
-{{/each}}
-
-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 objectId: 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}}", "{{escape objectId}}", {{{attributeSource}}})
-{{/each}}
-{{/if}}
-}
-
-{{#if objects.length}}
-export type GeneratedAttioObject =
-{{#each objects}}
-    | typeof AttioObject.{{staticName}}
-{{/each}}
-{{else}}
-export type GeneratedAttioObject = AttioObject
-{{/if}}
-
-export class AttioList<
-    TSlug extends string = string,
-    TEntryValues extends Record<string, unknown> = Record<string, unknown>,
-    TEntryRecordValues extends Record<string, unknown> = TEntryValues
-> {
-    constructor(
-        public readonly apiSlug: TSlug,
-        public readonly name: string,
-        public readonly listId: string,
-        public readonly parentObject: string,
-        public readonly attributes: readonly AttioAttributeDefinition[] = []
-    ) {}
-
-    declare readonly __entryValues: TEntryValues
-    declare readonly __entryRecordValues: TEntryRecordValues
-{{#if lists.length}}
-
-{{#each lists}}
-    static {{staticName}} = new AttioList<"{{escape apiSlug}}", {{{entryValuesType}}}, {{{entryRecordValuesType}}}>("{{escape apiSlug}}", "{{escape name}}", "{{escape listId}}", "{{escape parentObject}}", {{{attributeSource}}})
-{{/each}}
-{{/if}}
-}
-
-{{#if lists.length}}
-export type GeneratedAttioList =
-{{#each lists}}
-    | typeof AttioList.{{staticName}}
-{{/each}}
-{{else}}
-export type GeneratedAttioList = AttioList
-{{/if}}
-
-function attioParentObjectFilter(object: GeneratedAttioObject | undefined) {
-    if (!object) return null
-    return { $and: [{ field: "id.object_id", operator: "equals" as const, value: object.objectId }] }
-}
-
-{{#each runtimeLines}}
-{{{this}}}
-{{/each}}
-

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

@@ -1,3 +0,0 @@
-{{sectionHeader "Datadog"}}
-
-{{> resource-class indexClass}}

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

@@ -1,30 +0,0 @@
-{{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}}
-}

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

@@ -1,17 +0,0 @@
-// Auto-generated by `terse generate` — do not edit manually
-// Re-run `terse generate` to update.
-
-{{#if availableIntegrations}}
-// The integrations currently available in Terse: {{availableIntegrations}}.
-// Connect one with `terse integrate connect <type>`; list its tools with `terse integrate tool <type> --json`.
-{{/if}}
-
-{{#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/hey-reach-section.hbs

@@ -1,3 +0,0 @@
-{{sectionHeader "HeyReach"}}
-
-{{> resource-class campaignClass}}

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

@@ -1,3 +0,0 @@
-{{sectionHeader "LaunchDarkly"}}
-
-{{> resource-class projectClass}}

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

@@ -1,5 +0,0 @@
-{{sectionHeader "Linear"}}
-
-{{> resource-class teamClass}}
-
-{{> resource-class projectClass}}

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

@@ -1,5 +0,0 @@
-{{sectionHeader "Notion"}}
-
-{{> resource-class databaseClass}}
-
-{{> resource-class pageClass}}

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

@@ -1,15 +0,0 @@
-{{sectionHeader "PostHog"}}
-
-{{> resource-class projectClass}}
-
-{{#if 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 eventNames}}
-    | "{{escape this}}"
-{{/each}}
-{{/if}}

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

@@ -1,99 +0,0 @@
-{{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 = {
-{{#if slack}}
-    /** Slack — send messages and manage threads in a specific channel */
-    slack(opts: { channel: SlackChannel; userIds?: string[]; userNames?: string[]; listenToUserDms?: boolean }): TypedSkill<{{{slack.skillToolType}}}> {
-        return new SlackOutputConfig("{{escape slack.id}}", opts.channel.channelId ?? null, opts.channel.name ?? null, opts.userIds ?? [], opts.userNames ?? null, opts.listenToUserDms)
-    },
-{{/if}}
-{{#if github}}
-    /** GitHub — read code and pull requests from the given repositories */
-    github(opts: { repos: Repos[] }): TypedSkill<{{{github.skillToolType}}}> {
-        return new GitHubConfig("{{escape github.id}}", opts.repos.map(r => r.repositoryId))
-    },
-{{/if}}
-{{#if linear}}
-    /** Linear — read and write issues, optionally scoped to a team or project */
-    linear(opts?: { team?: LinearTeam; project?: LinearProject }): TypedSkill<{{{linear.skillToolType}}}> {
-        return new LinearOutputConfig(
-            "{{escape linear.id}}",
-            opts?.team?.teamId ?? null,
-            opts?.team?.name ?? null,
-            opts?.project?.projectId ?? null
-        )
-    },
-{{/if}}
-{{#if gmail}}
-    /** Gmail — send emails */
-    gmail(): TypedSkill<{{{gmail.skillToolType}}}> {
-        return new GmailOutputConfig("{{escape gmail.id}}")
-    },
-    /** Gmail — create draft emails (no auto-send) */
-    gmailDraft(): TypedSkill<{{{gmail.skillToolType}}}> {
-        return new GmailDraftOutputConfig("{{escape gmail.id}}")
-    },
-{{/if}}
-{{#if notion}}
-    /** Notion — read and write to the given databases or pages */
-    notion(opts?: { databases?: NotionDatabase[]; pages?: NotionPage[] }): TypedSkill<{{{notion.skillToolType}}}> {
-        return new NotionConfig("{{escape notion.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))
-    },
-{{/if}}
-{{#if posthog}}
-    /** PostHog — query analytics for a specific project */
-    posthog(opts: { project: PosthogProject }): TypedSkill<{{{posthog.skillToolType}}}> {
-        return new PosthogConfig("{{escape posthog.id}}", opts.project.projectId, opts.project.name)
-    },
-{{/if}}
-{{#if datadog}}
-    /** Datadog — search and analyze logs, optionally scoped to specific indexes */
-    datadog(opts?: { indexes?: DatadogIndex[] }): TypedSkill<{{{datadog.skillToolType}}}> {
-        return new DatadogConfig("{{escape datadog.id}}", opts?.indexes?.map(i => i.name))
-    },
-{{/if}}
-{{#if launchdarkly}}
-    /** LaunchDarkly — read and toggle feature flags in a project + environments */
-    launchDarkly(opts: { project: LaunchDarklyProject; environmentKeys: string[] }): TypedSkill<{{{launchdarkly.skillToolType}}}> {
-        return new LaunchDarklyConfig("{{escape launchdarkly.id}}", opts.project.projectKey, opts.environmentKeys)
-    },
-{{/if}}
-{{#if workos}}
-    /** WorkOS — manage users, organizations and invitations */
-    workOS(): TypedSkill<{{{workos.skillToolType}}}> {
-        return new WorkOSOutputConfig("{{escape workos.id}}")
-    },
-{{/if}}
-{{#if attio}}
-    /** Attio — query and upsert records on a CRM object */
-    attio(opts: { object: AttioObject<any> }): TypedSkill<{{{attio.skillToolType}}}> {
-        return new AttioOutputConfig("{{escape attio.id}}", opts.object.apiSlug)
-    },
-{{/if}}
-{{#if snowflake}}
-    /** Snowflake — run SQL queries against your warehouse */
-    snowflake(): TypedSkill<{{{snowflake.skillToolType}}}> {
-        return new SnowflakeOutputConfig("{{escape snowflake.id}}")
-    },
-{{/if}}
-    /** 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). */
-    web(opts: { allowedDomains?: string[] } = {}): TypedSkill<"web_search" | "web_extract" | "web_research"> {
-        return new WebConfig(opts)
-    },
-    /** ImageEdit — edit and generate images */
-    imageEdit(): 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. */
-    memory(): TypedSkill<"memory"> {
-        return new MemoryConfig()
-    },
-}

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

@@ -1,5 +0,0 @@
-{{sectionHeader "Slack"}}
-
-{{> resource-class channelClass}}
-
-{{> resource-class userClass}}

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

@@ -1,94 +0,0 @@
-{{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 allowed: Set<string> = new Set(agent.skills.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
-
-/**
- * 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 groups}}
-    {{key}}: {
-{{#each methods}}
-{{#each runtimeLines}}
-        {{{this}}}
-{{/each}}
-{{/each}}
-    },
-{{/each}}
-}