terse-sdk 0.1.50 → 0.1.52

package/README.md

@@ -16,28 +16,42 @@ The fastest way to get started is `npm install -g terse-cli && terse init my-pro
 
 ## Example
 
-What `terse init` scaffolds in `src/terse.jobs.ts`:
+A Terse workflow is a single TypeScript file. The job below watches a repo for new pull requests, posts a deterministic Slack message, then threads an agent-written summary under it:
 
 ```ts
-import { createJob, TerseAgent } from "terse-sdk"
-import { z } from "zod"
-
-import { Triggers } from "./terse.generated"
+import { GithubPRTrigger, TerseAgent, createJob } from "terse-sdk"
+import { Repos, Skills, SlackChannel, Triggers } from "../terse.generated"
+// ^^ Generated based on your workspace
 
 createJob({
-    name: "Tell a programming joke example job",
-    triggers: [Triggers.schedule.cron({ expression: "0 9 * * 1" })],
-    onTrigger: async (event) => {
+    name: "Summarize PR and send slack message",
+    triggers: [Triggers.github.onPROpened({ repo: Repos.TerseAI.Terse })],
+    onTrigger: async (event: GithubPRTrigger) => {
+        // Create durable Agents
+        const prompt = "Summarize the incoming PR and send to slack. Format the summary in Block Kit; include screenshots or diagrams from the PR as image blocks."
         const agent = TerseAgent.create({
-            prompt: "You are a helpful assistant that tells programming jokes.",
-            skills: []
+            prompt,
+            skills: [
+                // Fine tune what agents have access to. Impossible to modify anything outside of this scope
+                Skills.github({ repos: [Repos.TerseAI.Terse] }),
+                Skills.slack({ channel: SlackChannel.AllTerseInc })
+            ]
+        })
+
+        // deterministically call a tool
+        const message = await agent.tools.slack.sendMessage({
+            channelId: SlackChannel.AllTerseInc.channelId,
+            message: "New PR from " + event.sender.login + "!"
         })
 
-        const response = await agent.runAndWait("Tell me a programming joke.", z.object({
-            joke: z.string()
-        }))
+        // Outputs are strongly typed
+        const parentId = message.message_ts
 
-        console.log(response.joke)
+        // Trigger the Agent with Github + Slack tools auto added
+        await agent.runAndWait(`
+        Summarize this PR ${event.formatForAgentRunner()}.
+        Keep it short. Reply in a thread to the Slack message (thread parent ts: ${parentId}).
+        `)
     }
 })
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-sdk",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -23,7 +23,7 @@
     "zod": "^4.3.6"
   },
   "dependencies": {
-    "terse-types": "0.0.45"
+    "terse-types": "0.0.47"
   },
   "scripts": {
     "build": "tsc",