@orderful/droid 0.39.1 → 0.40.1

package/dist/commands/integrations.d.ts

@@ -0,0 +1,10 @@
+export declare function integrationsSetupSlackCommand(): Promise<void>;
+export declare function integrationsStatusCommand(): Promise<void>;
+/**
+ * Post a message or edit a canvas via Slack SDK.
+ * Reads JSON from stdin, outputs JSON result to stdout.
+ */
+export declare function slackPostCommand(options: {
+    canvas?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/commands/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/commands/integrations.ts"],"names":[],"mappings":"AAoNA,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAuInE;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqC/D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCnF"}

package/dist/commands/tui/components/IntegrationsDetails.d.ts

@@ -0,0 +1,6 @@
+export interface IntegrationsDetailsProps {
+    isFocused: boolean;
+    selectedAction: number;
+}
+export declare function IntegrationsDetails({ isFocused, selectedAction, }: IntegrationsDetailsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=IntegrationsDetails.d.ts.map

package/dist/commands/tui/components/IntegrationsDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrationsDetails.d.ts","sourceRoot":"","sources":["../../../../src/commands/tui/components/IntegrationsDetails.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAAc,GACf,EAAE,wBAAwB,2CAmF1B"}

package/dist/commands/tui/components/Markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../../src/commands/tui/components/Markdown.tsx"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,2CA4CzF"}
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../../src/commands/tui/components/Markdown.tsx"],"names":[],"mappings":"AA+DA,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,2CAiDzF"}

package/dist/commands/tui/types.d.ts

@@ -1,4 +1,4 @@
-export type Tab = 'tools' | 'settings';
+export type Tab = 'tools' | 'integrations' | 'settings';
 export type View = 'welcome' | 'tool-updates' | 'setup' | 'menu' | 'detail' | 'configure' | 'readme' | 'explorer' | 'repos' | 'view-repos';
 export type SetupStep = 'user_mention' | 'auto_update' | 'confirm';
 export type ComponentType = 'skill' | 'command' | 'agent';

package/dist/commands/tui/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/tui/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,UAAU,CAAC;AACvC,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;AAC3I,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/tui/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;AACxD,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;AAC3I,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC"}

package/dist/commands/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AA+lBA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBhD"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AAuqBA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBhD"}

package/dist/index.js

@@ -135,6 +135,33 @@ function migrateToolConfigs(config) {
     return false;
   }
 }
+function migrateIntegrations(config) {
+  if (config.migrations?.integrations_consolidated) {
+    return false;
+  }
+  const statusUpdateConfig = config.tools?.["status-update"];
+  if (statusUpdateConfig && "default_crosspost_channel" in statusUpdateConfig) {
+    const channel = statusUpdateConfig.default_crosspost_channel;
+    if (!config.integrations) {
+      config.integrations = {};
+    }
+    if (!config.integrations.slack) {
+      config.integrations.slack = {};
+    }
+    if (!config.integrations.slack.crosspost_channel && channel) {
+      config.integrations.slack.crosspost_channel = channel;
+    }
+    delete statusUpdateConfig.default_crosspost_channel;
+    if (Object.keys(statusUpdateConfig).length === 0) {
+      delete config.tools["status-update"];
+    }
+  }
+  if (!config.migrations) {
+    config.migrations = {};
+  }
+  config.migrations.integrations_consolidated = true;
+  return true;
+}
 function ensureConfigDir() {
   if (!existsSync(CONFIG_DIR)) {
     mkdirSync(CONFIG_DIR, { recursive: true });
@@ -154,7 +181,8 @@ function loadConfig() {
     const needsLegacyMigration = "ai_tool" in rawConfig && !("platform" in rawConfig);
     const config = migrateConfig(rawConfig);
     const needsToolMigration = migrateToolConfigs(config);
-    if (needsLegacyMigration || needsToolMigration) {
+    const needsIntegrationsMigration = migrateIntegrations(config);
+    if (needsLegacyMigration || needsToolMigration || needsIntegrationsMigration) {
       saveConfig(config);
     }
     return config;

package/dist/integrations/slack/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Slack integration — SDK wrapper + token helpers
+ *
+ * Uses @slack/web-api for all API calls (postMessage, canvases.edit, OAuth exchange).
+ * Each function creates its own WebClient instance (appropriate for CLI — no long-lived connections).
+ */
+export declare function getSlackToken(): string | undefined;
+export declare function hasSlackToken(): boolean;
+export interface PostMessageParams {
+    channel: string;
+    text: string;
+    unfurl_links?: boolean;
+}
+export interface PostMessageResult {
+    ok: boolean;
+    ts?: string;
+    channel?: string;
+    error?: string;
+}
+export declare function postMessage(params: PostMessageParams): Promise<PostMessageResult>;
+export interface CanvasChange {
+    operation: string;
+    document_content: {
+        type: string;
+        markdown: string;
+    };
+}
+export interface EditCanvasResult {
+    ok: boolean;
+    error?: string;
+}
+export declare function editCanvas(params: {
+    canvas_id: string;
+    changes: CanvasChange[];
+}): Promise<EditCanvasResult>;
+export interface ExchangeOAuthResult {
+    ok: boolean;
+    token?: string;
+    error?: string;
+}
+export declare function exchangeOAuthCode(clientId: string, clientSecret: string, code: string, redirectUri: string): Promise<ExchangeOAuthResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/slack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAMD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0BvF;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsB5B;AAMD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA0B9B"}

package/dist/integrations/slack/index.ts

@@ -0,0 +1,148 @@
+/**
+ * Slack integration — SDK wrapper + token helpers
+ *
+ * Uses @slack/web-api for all API calls (postMessage, canvases.edit, OAuth exchange).
+ * Each function creates its own WebClient instance (appropriate for CLI — no long-lived connections).
+ */
+
+import { WebClient } from '@slack/web-api';
+
+// ---------------------------------------------------------------------------
+// Token helpers (absorbed from secrets.ts)
+// ---------------------------------------------------------------------------
+
+export function getSlackToken(): string | undefined {
+  return process.env.SLACK_USER_TOKEN;
+}
+
+export function hasSlackToken(): boolean {
+  return !!process.env.SLACK_USER_TOKEN;
+}
+
+// ---------------------------------------------------------------------------
+// API operations
+// ---------------------------------------------------------------------------
+
+export interface PostMessageParams {
+  channel: string;
+  text: string;
+  unfurl_links?: boolean;
+}
+
+export interface PostMessageResult {
+  ok: boolean;
+  ts?: string;
+  channel?: string;
+  error?: string;
+}
+
+export async function postMessage(params: PostMessageParams): Promise<PostMessageResult> {
+  const token = getSlackToken();
+  if (!token) {
+    return { ok: false, error: 'SLACK_USER_TOKEN not set. Run: droid integrations setup slack' };
+  }
+
+  const client = new WebClient(token);
+
+  try {
+    const result = await client.chat.postMessage({
+      channel: params.channel,
+      text: params.text,
+      unfurl_links: params.unfurl_links,
+    });
+
+    return {
+      ok: result.ok ?? false,
+      ts: result.ts,
+      channel: result.channel,
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}
+
+export interface CanvasChange {
+  operation: string;
+  document_content: {
+    type: string;
+    markdown: string;
+  };
+}
+
+export interface EditCanvasResult {
+  ok: boolean;
+  error?: string;
+}
+
+export async function editCanvas(params: {
+  canvas_id: string;
+  changes: CanvasChange[];
+}): Promise<EditCanvasResult> {
+  const token = getSlackToken();
+  if (!token) {
+    return { ok: false, error: 'SLACK_USER_TOKEN not set. Run: droid integrations setup slack' };
+  }
+
+  const client = new WebClient(token);
+
+  try {
+    const result = await client.canvases.edit({
+      canvas_id: params.canvas_id,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      changes: params.changes as any,
+    });
+
+    return { ok: result.ok ?? false };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}
+
+// ---------------------------------------------------------------------------
+// OAuth (no token needed for exchange)
+// ---------------------------------------------------------------------------
+
+export interface ExchangeOAuthResult {
+  ok: boolean;
+  token?: string;
+  error?: string;
+}
+
+export async function exchangeOAuthCode(
+  clientId: string,
+  clientSecret: string,
+  code: string,
+  redirectUri: string,
+): Promise<ExchangeOAuthResult> {
+  try {
+    const client = new WebClient();
+    const result = await client.oauth.v2.access({
+      client_id: clientId,
+      client_secret: clientSecret,
+      code,
+      redirect_uri: redirectUri,
+    });
+
+    if (!result.ok) {
+      return { ok: false, error: String(result.error ?? 'Unknown error') };
+    }
+
+    const token = result.authed_user?.access_token;
+    if (!token) {
+      return { ok: false, error: 'No user token in response' };
+    }
+
+    return { ok: true, token };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}

package/dist/integrations/slack/references/setup.md

@@ -0,0 +1,53 @@
+# Slack Integration Setup
+
+## Prerequisites
+
+1. Get the **Client ID** and **Client Secret** from 1Password (search "Droid Slack App")
+2. Add them to your shell config (e.g. `~/.zshrc`):
+
+```bash
+export SLACK_CLIENT_ID="your-client-id"
+export SLACK_CLIENT_SECRET="your-client-secret"
+```
+
+3. Reload your shell: `source ~/.zshrc`
+
+## Setup
+
+Run the OAuth flow:
+
+```bash
+droid integrations setup slack
+```
+
+Or use the **Run Setup** button in `droid` TUI → Integrations tab.
+
+This will:
+- Generate a local HTTPS certificate (stored in `~/.droid/certs/`)
+- Offer to trust it in your macOS Keychain (avoids browser warnings)
+- Open your browser to Slack's authorisation page
+- Catch the redirect on a local callback server (port 9876)
+- Exchange the code for a user token via the Slack SDK
+- Write `SLACK_USER_TOKEN` to your shell rc file
+
+## Verify
+
+```bash
+droid integrations status
+```
+
+You should see all three credentials marked as set and status as "Configured".
+
+## Usage by AI
+
+Post a message:
+```bash
+node -e 'process.stdout.write(JSON.stringify({channel:"#eng",text:"hello"}))' | \
+  droid integrations slack post
+```
+
+Edit a canvas:
+```bash
+node -e 'process.stdout.write(JSON.stringify({canvas_id:"F123",changes:[{operation:"insert_at_end",document_content:{type:"markdown",markdown:"Content here"}}]}))' | \
+  droid integrations slack post --canvas
+```

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AA2HjB;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAgCxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAKpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAWD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAsBpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,GACxB,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAGxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAOxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAI9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAQ5E;AAYD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,UAAU,EAAE,CAGvC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAG5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAiB9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAchD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAwKjB;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAmCxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAKpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAWD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAsBpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,GACxB,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAGxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAOxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAI9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAQ5E;AAYD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,UAAU,EAAE,CAGvC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAG5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAiB9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAchD"}

package/dist/lib/types.d.ts

@@ -40,6 +40,13 @@ export interface RepoConfig {
     description?: string;
 }
 export type ToolConfig = Record<string, unknown>;
+export interface IntegrationSlackConfig {
+    configured?: boolean;
+    crosspost_channel?: string;
+}
+export interface IntegrationsConfig {
+    slack?: IntegrationSlackConfig;
+}
 export interface DroidConfig {
     platform: Platform;
     user_mention: string;
@@ -48,12 +55,14 @@ export interface DroidConfig {
     platforms: Record<string, PlatformConfig>;
     repos?: RepoConfig[];
     tools?: Record<string, ToolConfig>;
+    integrations?: IntegrationsConfig;
     auto_update?: AutoUpdateConfig;
     ignored_platforms?: Platform[];
     migrations?: {
         package?: string;
         tools?: Record<string, string>;
         tools_consolidated?: boolean;
+        integrations_consolidated?: boolean;
         [key: string]: string | Record<string, string> | boolean | undefined;
     };
 }

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/status-update/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-status-update",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Generate and post project status updates. Aggregates context from codex projects, Jira epics, and manual input. Posts to Slack or prints to terminal.",
   "author": {
     "name": "Orderful",

package/dist/tools/status-update/TOOL.yaml

@@ -1,6 +1,6 @@
 name: status-update
 description: "Generate and post project status updates. Aggregates context from codex projects, Jira epics, and manual input. Posts to Slack or prints to terminal."
-version: 0.1.0
+version: 0.2.1
 status: beta
 
 includes:
@@ -14,8 +14,4 @@ includes:
 
 dependencies: []
 
-config_schema:
-  default_crosspost_channel:
-    type: string
-    description: Default channel for cross-posting updates (e.g., rnd-updates)
-    required: false
+config_schema: {}

package/dist/tools/status-update/skills/status-update/SKILL.md

@@ -8,7 +8,6 @@ allowed-tools:
     Glob,
     Grep,
     Bash(git:*),
-    Bash(curl:*),
     Bash(droid:*),
   ]
 ---
@@ -179,14 +178,8 @@ Add ` & :codex:` to footer if codex project was used.
 
 **Post to primary channel:**
 ```bash
-curl -s -X POST https://slack.com/api/chat.postMessage \
-  -H "Authorization: Bearer $SLACK_USER_TOKEN" \
-  -H "Content-Type: application/json; charset=utf-8" \
-  -d '{
-    "channel": "{slack.channel}",
-    "text": "{formatted_message}",
-    "unfurl_links": false
-  }'
+node -e 'process.stdout.write(JSON.stringify({channel:"{slack.channel}",text:`{formatted_message}`,unfurl_links:false}))' | \
+  droid integrations slack post
 ```
 
 Check response for `"ok": true`. Save `ts` and `channel` from response.
@@ -207,21 +200,15 @@ Post summary version with link to full update:
 
 Message URL format: `https://orderful.slack.com/archives/{channel_id}/p{ts_without_dot}`
 
+```bash
+node -e 'process.stdout.write(JSON.stringify({channel:"{crosspost_channel}",text:`{crosspost_message}`,unfurl_links:false}))' | \
+  droid integrations slack post
+```
+
 **Update canvas log (if canvas_id configured):**
 ```bash
-curl -s -X POST https://slack.com/api/canvases.edit \
-  -H "Authorization: Bearer $SLACK_USER_TOKEN" \
-  -H "Content-Type: application/json; charset=utf-8" \
-  -d '{
-    "canvas_id": "{slack.canvas_id}",
-    "changes": [{
-      "operation": "insert_at_start",
-      "document_content": {
-        "type": "markdown",
-        "markdown": "### {date}\n{status} · {current_phase}\n[View update]({message_url})\n\n---"
-      }
-    }]
-  }'
+node -e 'process.stdout.write(JSON.stringify({canvas_id:"{slack.canvas_id}",changes:[{operation:"insert_at_start",document_content:{type:"markdown",markdown:"### {date}\n{status} · {current_phase}\n[View update]({message_url})\n\n---"}}]}))' | \
+  droid integrations slack post --canvas
 ```
 
 **Confirm to user:**
@@ -233,21 +220,22 @@ curl -s -X POST https://slack.com/api/canvases.edit \
 
 Print the formatted message to terminal.
 
-Tell user: "Slack not configured. To post updates directly, add `slack.channel` to your project's CONTEXT.md and set `SLACK_USER_TOKEN` in your environment."
+Tell user: "Slack not configured. To post updates directly, add `slack.channel` to your project's CONTEXT.md and run `droid integrations setup slack`."
 
 ### Error Handling
 
 | Error | Action |
 |-------|--------|
-| No SLACK_USER_TOKEN | Print to terminal, suggest setup |
+| No SLACK_USER_TOKEN | Print to terminal, suggest `droid integrations setup slack` |
 | Slack API error | Show error, offer to print instead |
 | Jira MCP not available | Skip Jira, continue with other sources |
 | No codex project found | Continue with manual input |
 
 ## Configuration
 
-No required configuration. Optional settings via `droid config`:
+No required configuration. Slack settings are shared via `droid config --get integrations.slack`:
 
 | Setting | Description |
 |---------|-------------|
-| `default_crosspost_channel` | Default channel for cross-posts if not in project metadata |
+| `integrations.slack.crosspost_channel` | Default channel for cross-posts if not in project metadata |
+| `integrations.slack.configured` | Whether Slack integration has been set up |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.39.1",
+  "version": "0.40.1",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {
@@ -45,6 +45,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@slack/web-api": "^7.13.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "ink": "^6.5.1",

package/scripts/build.ts

@@ -69,6 +69,10 @@ async function main() {
   console.log('Copying tools...');
   cpSync('src/tools', 'dist/tools', { recursive: true });
 
+  // Copy integrations directory (references, etc.)
+  console.log('Copying integrations...');
+  cpSync('src/integrations', 'dist/integrations', { recursive: true });
+
   console.log('Build complete!');
 }
 

package/src/bin/droid.ts

@@ -16,7 +16,7 @@ import {
   reposRemoveCommand,
   reposGetCommand,
 } from '../commands/repos';
-import { authSlackCommand, authStatusCommand } from '../commands/auth';
+import { integrationsSetupSlackCommand, integrationsStatusCommand, slackPostCommand } from '../commands/integrations';
 import { getVersion } from '../lib/version';
 import { loadConfig, saveConfig, configExists } from '../lib/config';
 import { syncNewPlatforms } from '../lib/platforms';
@@ -110,23 +110,37 @@ program
   .allowUnknownOption()
   .action(execCommand);
 
-// Auth command with subcommands
-const auth = program
-  .command('auth')
-  .description('Set up authentication for external services');
+// Integrations command with subcommands
+const integrations = program
+  .command('integrations')
+  .description('Manage external service integrations');
 
-auth
+const integrationsSetup = integrations
+  .command('setup')
+  .description('Set up an integration');
+
+integrationsSetup
   .command('slack')
-  .description('Set up Slack authentication for status updates')
-  .action(authSlackCommand);
+  .description('Set up Slack integration')
+  .action(integrationsSetupSlackCommand);
 
-auth
+integrations
   .command('status')
-  .description('Show authentication status')
-  .action(authStatusCommand);
+  .description('Show integration status')
+  .action(integrationsStatusCommand);
+
+const integrationsSlack = integrations
+  .command('slack')
+  .description('Slack integration commands');
+
+integrationsSlack
+  .command('post')
+  .description('Post a message or edit a canvas (JSON from stdin)')
+  .option('--canvas', 'Edit a canvas instead of posting a message')
+  .action((options) => slackPostCommand(options));
 
-// Default: show auth status if no subcommand
-auth.action(authStatusCommand);
+// Default: show status if no subcommand
+integrations.action(integrationsStatusCommand);
 
 // Sync new platforms before running any command
 // This ensures that newly installed platforms (e.g., Codex) get all existing tools