terse-cli 0.1.17 → 0.1.18

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

@@ -0,0 +1,178 @@
+{{#if slack}}
+
+
+# === Slack ===
+
+
+class SlackChannel(BaseModel):
+    model_config = ConfigDict(frozen=True)
+    channel_id: str
+    name: str
+{{#if slack.channels.length}}
+{{#each slack.channels}}
+    {{staticName}}: ClassVar["SlackChannel"]
+{{/each}}
+
+{{#each slack.channels}}
+SlackChannel.{{staticName}} = SlackChannel(channel_id={{{channelIdRepr}}}, name={{{nameRepr}}})
+{{/each}}
+{{/if}}
+
+
+class Slack:
+    @staticmethod
+    def on_message(channel: SlackChannel, *, user_ids: Sequence[str] | None = None) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id={{{slack.instanceIdRepr}}},
+            integration_type='slack',
+            event_type='message',
+            config_type='slack',
+            config=_compact_dict(
+                channelId=channel.channel_id,
+                channelName=channel.name,
+                listenToUserDms=False,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=['message'],
+            ),
+        )
+
+    @staticmethod
+    def on_dm(*, user_ids: Sequence[str] | None = None) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id={{{slack.instanceIdRepr}}},
+            integration_type='slack',
+            event_type='message',
+            config_type='slack',
+            config=_compact_dict(
+                listenToUserDms=True,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=['message'],
+            ),
+        )
+
+    @staticmethod
+    def trigger(
+        *,
+        channel: SlackChannel | None = None,
+        listen_to_user_dms: bool | None = None,
+        user_ids: Sequence[str] | None = None,
+        event_types: Sequence[SlackEventType] | None = None,
+    ) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id={{{slack.instanceIdRepr}}},
+            integration_type='slack',
+            config_type='slack',
+            config=_compact_dict(
+                channelId=channel.channel_id if channel is not None else None,
+                channelName=channel.name if channel is not None else None,
+                listenToUserDms=listen_to_user_dms,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=list(event_types) if event_types is not None else None,
+            ),
+        )
+
+    @staticmethod
+    def skill(
+        *,
+        channel: SlackChannel | None = None,
+        user_ids: Sequence[str] | None = None,
+        user_names: Sequence[str] | None = None,
+        listen_to_user_dms: bool | None = None,
+    ) -> SkillConfig[{{slack.skillToolType}}]:
+        return SkillConfig(
+            integration_id={{{slack.instanceIdRepr}}},
+            integration_type='slack',
+            config_type='slack_output',
+            config=_compact_dict(
+                channelId=channel.channel_id if channel is not None else None,
+                channelName=channel.name if channel is not None else None,
+                userIds=list(user_ids) if user_ids is not None else None,
+                userNames=list(user_names) if user_names is not None else None,
+                listenToUserDms=listen_to_user_dms,
+            ),
+        )
+{{else}}
+
+
+# === Slack ===
+
+
+class SlackChannel:
+    def __init__(self, channel_id: str, name: str) -> None:
+        self.channel_id = channel_id
+        self.name = name
+
+
+class Slack:
+    @staticmethod
+    def on_message(channel: SlackChannel, *, user_ids: list[str] | None = None) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id='slack_placeholder',
+            integration_type='slack',
+            event_type='message',
+            config_type='slack',
+            config=_compact_dict(
+                channelId=channel.channel_id,
+                channelName=channel.name,
+                listenToUserDms=False,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=['message'],
+            ),
+        )
+
+    @staticmethod
+    def on_dm(*, user_ids: list[str] | None = None) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id='slack_placeholder',
+            integration_type='slack',
+            event_type='message',
+            config_type='slack',
+            config=_compact_dict(
+                listenToUserDms=True,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=['message'],
+            ),
+        )
+
+    @staticmethod
+    def trigger(
+        *,
+        channel: SlackChannel | None = None,
+        listen_to_user_dms: bool | None = None,
+        user_ids: list[str] | None = None,
+        event_types: list[str] | None = None,
+    ) -> TriggerConfig:
+        return TriggerConfig(
+            integration_id='slack_placeholder',
+            integration_type='slack',
+            config_type='slack',
+            config=_compact_dict(
+                channelId=channel.channel_id if channel is not None else None,
+                channelName=channel.name if channel is not None else None,
+                listenToUserDms=listen_to_user_dms,
+                userIds=list(user_ids) if user_ids is not None else None,
+                eventTypes=list(event_types) if event_types is not None else None,
+            ),
+        )
+
+    @staticmethod
+    def skill(
+        *,
+        channel: SlackChannel | None = None,
+        user_ids: list[str] | None = None,
+        user_names: list[str] | None = None,
+        listen_to_user_dms: bool | None = None,
+    ) -> SkillConfig[str]:
+        return SkillConfig(
+            integration_id='slack_placeholder',
+            integration_type='slack',
+            config_type='slack_output',
+            config=_compact_dict(
+                channelId=channel.channel_id if channel is not None else None,
+                channelName=channel.name if channel is not None else None,
+                userIds=list(user_ids) if user_ids is not None else None,
+                userNames=list(user_names) if user_names is not None else None,
+                listenToUserDms=listen_to_user_dms,
+            ),
+        )
+{{/if}}

package/templates/python/codegen/partials/tool-name-types.hbs

@@ -6,6 +6,9 @@
 {{#if attioToolNamesLiteral}}
 AttioToolNames = Literal[{{{attioToolNamesLiteral}}}]
 {{/if}}
+{{#if slackToolNamesLiteral}}
+SlackToolNames = Literal[{{{slackToolNamesLiteral}}}]
+{{/if}}
 {{#if snowflakeToolNamesLiteral}}
 SnowflakeToolNames = Literal[{{{snowflakeToolNamesLiteral}}}]
 {{/if}}

package/templates/python/init/README.md.hbs

@@ -27,12 +27,14 @@ Edit `src/main.py` to register jobs with `@app.job(...)`.
 
 The starter scaffold registers `Attio.skill()` and `Snowflake.skill()` by default.
 
-After you connect Attio or Snowflake in Terse, rerun `terse generate` to refresh `src/terse_generated.py` with the real integration IDs and deterministic tool wrappers.
+After you connect Attio, Slack, or Snowflake in Terse, rerun `terse generate` to refresh `src/terse_generated.py` with the real integration IDs, generated resources, and deterministic tool wrappers.
 
-Import helpers like `Attio`, `AttioObject`, `Schedule`, `Snowflake`, and `TerseAgent` from `terse_generated`.
+Import helpers like `Attio`, `AttioObject`, `Schedule`, `Slack`, `SlackChannel`, `Snowflake`, and `TerseAgent` from `terse_generated`.
 
-If a job registers `skills=[Snowflake.skill()]`, it can call deterministic wrappers like:
+If a job includes the integration in `triggers=` or `skills=`, it can call deterministic wrappers like:
 
 ```python
 agent.tools.snowflake.execute_query(query="select 1")
 ```
+
+Use `agent.tools.slack.*` for direct deterministic Slack calls. Use `skills=[Slack.skill(...)]` when you want Slack to be visible to the model during `run()` or `run_and_wait()`.

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

@@ -4,20 +4,19 @@
 
 export const Slack = {
     /** Trigger on any message in a channel */
-    onMessage(opts: { channel: SlackChannel; userIds?: string[] }): SlackConfig {
+    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[] }): SlackConfig {
+    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[] }): SlackConfig {
+    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, opts?.channel?.name, opts?.userIds, opts?.userNames, opts?.listenToUserDms) as TypedSkill<{{{skillToolType}}}>
+    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/tools-section.hbs

@@ -51,7 +51,8 @@ declare module "terse-sdk" {
 }
 
 function createTools(agent: TerseAgent): GeneratedTools {
-    const allowed: Set<string> = new Set(agent.skills.map(s => s.integrationType))
+    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}}: {