@orchagent/cli 0.3.67 → 0.3.69

package/dist/commands/init.js

@@ -8,6 +8,7 @@ const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const errors_1 = require("../lib/errors");
 const github_weekly_summary_1 = require("./templates/github-weekly-summary");
+const support_agent_1 = require("./templates/support-agent");
 const MANIFEST_TEMPLATE = `{
   "name": "my-agent",
   "description": "A simple AI agent",
@@ -87,6 +88,51 @@ if __name__ == "__main__":
     main()
 `;
 function readmeTemplate(agentName, flavor) {
+    if (flavor === 'support_agent') {
+        return `# ${agentName}
+
+A multi-platform support agent powered by Claude. Connects to Discord, Telegram, and/or Slack.
+
+## Setup
+
+### 1. Customize
+
+Edit \`config.py\` — set your product name, description, and bot name.
+
+### 2. Add Knowledge
+
+Replace the example files in \`knowledge/\` with your own docs.
+Files named \`NN-topic-name.md\` auto-discover as topics.
+
+### 3. Set Platform Tokens
+
+Copy \`.env.example\` to \`.env\` and fill in tokens for the platforms you want.
+At least one platform token is required.
+
+### 4. Run Locally
+
+\`\`\`sh
+pip install -r requirements.txt
+python main.py
+\`\`\`
+
+### 5. Deploy
+
+\`\`\`sh
+orch publish
+# Add secrets in your workspace (web dashboard > Settings > Secrets)
+orch service deploy
+\`\`\`
+
+## Platforms
+
+| Platform | Token Required | Extra Config |
+|----------|---------------|--------------|
+| Discord | \`DISCORD_BOT_TOKEN\` | \`DISCORD_CHANNEL_IDS\` |
+| Telegram | \`TELEGRAM_BOT_TOKEN\` | — |
+| Slack | \`SLACK_BOT_TOKEN\` | \`SLACK_APP_TOKEN\` |
+`;
+    }
     if (flavor === 'discord') {
         return `# ${agentName}
 
@@ -479,7 +525,7 @@ function registerInitCommand(program) {
         .option('--type <type>', 'Type: prompt, tool, agent, or skill (legacy aliases: agentic, code)', 'prompt')
         .option('--orchestrator', 'Create an orchestrator agent with dependency scaffolding and SDK boilerplate')
         .option('--run-mode <mode>', 'Run mode for agents: on_demand or always_on', 'on_demand')
-        .option('--template <name>', 'Start from a template (available: github-weekly-summary, discord)')
+        .option('--template <name>', 'Start from a template (available: support-agent, discord, github-weekly-summary)')
         .action(async (name, options) => {
         const cwd = process.cwd();
         let runMode = (options.runMode || 'on_demand').trim().toLowerCase();
@@ -495,7 +541,7 @@ function registerInitCommand(program) {
         }
         if (options.template) {
             const template = options.template.trim().toLowerCase();
-            const validTemplates = ['discord', 'github-weekly-summary'];
+            const validTemplates = ['support-agent', 'discord', 'github-weekly-summary'];
             if (!validTemplates.includes(template)) {
                 throw new errors_1.CliError(`Unknown --template '${template}'. Available templates: ${validTemplates.join(', ')}`);
             }
@@ -505,7 +551,11 @@ function registerInitCommand(program) {
             if (initMode.type === 'skill') {
                 throw new errors_1.CliError('Cannot use --template with --type skill.');
             }
-            if (template === 'discord') {
+            if (template === 'support-agent') {
+                initMode = { type: 'agent', flavor: 'support_agent' };
+                runMode = 'always_on';
+            }
+            else if (template === 'discord') {
                 initMode = { type: 'agent', flavor: 'discord' };
                 runMode = 'always_on';
             }
@@ -550,6 +600,80 @@ function registerInitCommand(program) {
             }
             return;
         }
+        // Handle support-agent template separately (multi-file structure)
+        if (initMode.flavor === 'support_agent') {
+            const manifestPath = path_1.default.join(targetDir, 'orchagent.json');
+            try {
+                await promises_1.default.access(manifestPath);
+                throw new errors_1.CliError(`Already initialized (orchagent.json exists in ${name ? name + '/' : 'current directory'})`);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+            // Create subdirectories
+            await promises_1.default.mkdir(path_1.default.join(targetDir, 'connectors'), { recursive: true });
+            await promises_1.default.mkdir(path_1.default.join(targetDir, 'knowledge'), { recursive: true });
+            // Write manifest
+            const manifest = {
+                name: agentName,
+                type: 'agent',
+                description: 'Multi-platform support agent powered by Claude. Connects to Discord, Telegram, and/or Slack.',
+                run_mode: 'always_on',
+                runtime: { command: 'python main.py' },
+                entrypoint: 'main.py',
+                supported_providers: ['anthropic'],
+                default_models: { anthropic: 'claude-sonnet-4-5-20250929' },
+                required_secrets: [],
+                optional_secrets: ['DISCORD_BOT_TOKEN', 'DISCORD_CHANNEL_IDS', 'TELEGRAM_BOT_TOKEN', 'SLACK_BOT_TOKEN', 'SLACK_APP_TOKEN'],
+                tags: ['support', 'discord', 'telegram', 'slack', 'always-on', 'multi-platform'],
+                bundle: {
+                    include: ['*.py', 'connectors/*.py', 'knowledge/*.md', 'requirements.txt'],
+                    exclude: ['tests/', '__pycache__', '*.pyc', '.pytest_cache'],
+                },
+            };
+            await promises_1.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+            // Write all source files
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'config.py'), support_agent_1.SA_CONFIG_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'brain.py'), support_agent_1.SA_BRAIN_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.py'), support_agent_1.SA_MAIN_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'connectors', '__init__.py'), '');
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'connectors', 'discord_connector.py'), support_agent_1.SA_DISCORD_CONNECTOR_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'connectors', 'telegram_connector.py'), support_agent_1.SA_TELEGRAM_CONNECTOR_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'connectors', 'slack_connector.py'), support_agent_1.SA_SLACK_CONNECTOR_PY);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'requirements.txt'), support_agent_1.SA_REQUIREMENTS);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'knowledge', '00-overview.md'), support_agent_1.SA_OVERVIEW_MD);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'knowledge', '99-faq.md'), support_agent_1.SA_FAQ_MD);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, '.env.example'), support_agent_1.SA_ENV_EXAMPLE);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'README.md'), readmeTemplate(agentName, 'support_agent'));
+            const prefix = name ? name + '/' : '';
+            process.stdout.write(`\nInitialized support-agent "${agentName}" in ${targetDir}\n`);
+            process.stdout.write(`\nFiles created:\n`);
+            process.stdout.write(`  ${prefix}orchagent.json                       Agent manifest\n`);
+            process.stdout.write(`  ${prefix}config.py                            Customize here (4 fields)\n`);
+            process.stdout.write(`  ${prefix}brain.py                             Three-tier classifier + responder\n`);
+            process.stdout.write(`  ${prefix}main.py                              Startup orchestrator\n`);
+            process.stdout.write(`  ${prefix}connectors/discord_connector.py      Discord connector\n`);
+            process.stdout.write(`  ${prefix}connectors/telegram_connector.py     Telegram connector\n`);
+            process.stdout.write(`  ${prefix}connectors/slack_connector.py        Slack connector\n`);
+            process.stdout.write(`  ${prefix}knowledge/00-overview.md             Example FAQ knowledge\n`);
+            process.stdout.write(`  ${prefix}knowledge/99-faq.md                  Example FAQ knowledge\n`);
+            process.stdout.write(`  ${prefix}requirements.txt                     Python dependencies\n`);
+            process.stdout.write(`  ${prefix}.env.example                         Environment variables\n`);
+            process.stdout.write(`  ${prefix}README.md                            Setup guide\n`);
+            process.stdout.write(`\nNext steps:\n`);
+            const s = name ? 2 : 1;
+            if (name) {
+                process.stdout.write(`  1. cd ${name}\n`);
+            }
+            process.stdout.write(`  ${s}. Edit config.py with your product name and description\n`);
+            process.stdout.write(`  ${s + 1}. Replace knowledge/ files with your own docs\n`);
+            process.stdout.write(`  ${s + 2}. Copy .env.example to .env and add platform tokens\n`);
+            process.stdout.write(`  ${s + 3}. Test locally: pip install -r requirements.txt && python main.py\n`);
+            process.stdout.write(`  ${s + 4}. Deploy: orch publish && orch service deploy\n`);
+            return;
+        }
         // Handle github-weekly-summary template separately (own file set + output)
         if (initMode.flavor === 'github_weekly_summary') {
             const manifestPath = path_1.default.join(targetDir, 'orchagent.json');

package/dist/commands/publish.js

@@ -901,7 +901,7 @@ function registerPublishCommand(program) {
                 }
                 // Upload the bundle with entrypoint
                 process.stdout.write(`  Uploading bundle...\n`);
-                const uploadResult = await (0, api_1.uploadCodeBundle)(config, agentId, bundlePath, bundleEntrypoint);
+                const uploadResult = await (0, api_1.uploadCodeBundle)(config, agentId, bundlePath, bundleEntrypoint, workspaceId);
                 process.stdout.write(`  Uploaded: ${uploadResult.code_hash.substring(0, 12)}...\n`);
                 // Show environment info if applicable
                 if (uploadResult.environment_id) {

package/dist/commands/run.js

@@ -407,7 +407,7 @@ async function buildInjectedPayload(options) {
     return { body: JSON.stringify(merged), sourceLabel };
 }
 // ─── Local execution helpers ────────────────────────────────────────────────
-async function downloadAgent(config, org, agent, version) {
+async function downloadAgent(config, org, agent, version, workspaceId) {
     // Try public endpoint first
     try {
         return await (0, api_1.publicRequest)(config, `/public/agents/${org}/${agent}/${version}/download`);
@@ -421,7 +421,7 @@ async function downloadAgent(config, org, agent, version) {
                 // Try owner path if authenticated
                 if (config.apiKey) {
                     try {
-                        const myAgents = await (0, api_1.listMyAgents)(config);
+                        const myAgents = await (0, api_1.listMyAgents)(config, workspaceId);
                         const matchingAgent = myAgents.find(a => a.name === agent && a.version === version && a.org_slug === org);
                         if (matchingAgent) {
                             // Owner! Fetch from authenticated endpoint
@@ -470,12 +470,12 @@ async function downloadAgent(config, org, agent, version) {
     if (!config.apiKey) {
         throw new api_1.ApiError(`Agent '${org}/${agent}@${version}' not found`, 404);
     }
-    const userOrg = await (0, api_1.getOrg)(config);
+    const userOrg = await (0, api_1.getOrg)(config, workspaceId);
     if (userOrg.slug !== org) {
         throw new api_1.ApiError(`Agent '${org}/${agent}@${version}' not found`, 404);
     }
     // Find agent in user's list
-    const agents = await (0, api_1.listMyAgents)(config);
+    const agents = await (0, api_1.listMyAgents)(config, workspaceId);
     const matching = agents.filter(a => a.name === agent);
     if (matching.length === 0) {
         throw new api_1.ApiError(`Agent '${org}/${agent}@${version}' not found`, 404);
@@ -1616,7 +1616,9 @@ async function executeCloud(agentRef, file, options) {
     if (!org) {
         throw new errors_1.CliError('Missing org. Use org/agent or set default org.');
     }
-    const agentMeta = await (0, api_1.getAgentWithFallback)(resolved, org, parsed.agent, parsed.version);
+    // Resolve workspace context for the target org
+    const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(resolved, org);
+    const agentMeta = await (0, api_1.getAgentWithFallback)(resolved, org, parsed.agent, parsed.version, workspaceId);
     const cloudType = canonicalAgentType(agentMeta.type);
     const cloudEngine = resolveExecutionEngine({
         type: agentMeta.type,
@@ -1630,22 +1632,19 @@ async function executeCloud(agentRef, file, options) {
         const agentRequiredSecrets = agentMeta.required_secrets;
         if (agentRequiredSecrets?.length) {
             try {
-                const wsSlug = configFile.workspace;
-                if (wsSlug) {
-                    const { workspaces } = await (0, api_1.request)(resolved, 'GET', '/workspaces');
-                    const ws = workspaces.find((w) => w.slug === wsSlug);
-                    if (ws) {
-                        const secretsResult = await (0, api_1.request)(resolved, 'GET', `/workspaces/${ws.id}/secrets`);
-                        const existingNames = new Set(secretsResult.secrets.map((s) => s.name));
-                        const missing = agentRequiredSecrets.filter((s) => !existingNames.has(s));
-                        if (missing.length > 0) {
-                            throw new errors_1.CliError(`Agent requires secrets not found in workspace '${wsSlug}':\n` +
-                                missing.map((s) => `  - ${s}`).join('\n') + '\n\n' +
-                                `Set them before running:\n` +
-                                missing.map((s) => `  orch secrets set ${s} <value>`).join('\n') + '\n\n' +
-                                `Secrets are injected as environment variables into the agent sandbox.\n` +
-                                `View existing secrets: orch secrets list`);
-                        }
+                // Use already-resolved workspaceId (or fall back to config workspace slug)
+                const wsId = workspaceId ?? (configFile.workspace ? (await (0, api_1.resolveWorkspaceIdForOrg)(resolved, configFile.workspace)) : undefined);
+                if (wsId) {
+                    const secretsResult = await (0, api_1.request)(resolved, 'GET', `/workspaces/${wsId}/secrets`);
+                    const existingNames = new Set(secretsResult.secrets.map((s) => s.name));
+                    const missing = agentRequiredSecrets.filter((s) => !existingNames.has(s));
+                    if (missing.length > 0) {
+                        throw new errors_1.CliError(`Agent requires secrets not found in workspace '${org}':\n` +
+                            missing.map((s) => `  - ${s}`).join('\n') + '\n\n' +
+                            `Set them before running:\n` +
+                            missing.map((s) => `  orch secrets set ${s} <value>`).join('\n') + '\n\n' +
+                            `Secrets are injected as environment variables into the agent sandbox.\n` +
+                            `View existing secrets: orch secrets list`);
                     }
                 }
             }
@@ -1661,7 +1660,7 @@ async function executeCloud(agentRef, file, options) {
     if ((0, pricing_1.isPaidAgent)(agentMeta)) {
         let isOwner = false;
         try {
-            const callerOrg = await (0, api_1.getOrg)(resolved);
+            const callerOrg = await (0, api_1.getOrg)(resolved, workspaceId);
             const agentOrgId = agentMeta.org_id;
             const agentOrgSlug = agentMeta.org_slug;
             if (agentOrgId && callerOrg.id === agentOrgId) {
@@ -1714,6 +1713,9 @@ async function executeCloud(agentRef, file, options) {
         'X-CLI-Version': package_json_1.default.version,
         'X-OrchAgent-Client': 'cli',
     };
+    if (workspaceId) {
+        headers['X-Workspace-Id'] = workspaceId;
+    }
     if (options.tenant) {
         headers['X-OrchAgent-Tenant'] = options.tenant;
     }
@@ -2299,10 +2301,12 @@ async function executeLocal(agentRef, args, options) {
     if (!org) {
         throw new errors_1.CliError('Missing org. Use org/agent format.');
     }
+    // Resolve workspace context for the target org
+    const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(resolved, org);
     // Download agent definition with spinner
     const agentData = await (0, spinner_1.withSpinner)(`Downloading ${org}/${parsed.agent}@${parsed.version}...`, async () => {
         try {
-            return await downloadAgent(resolved, org, parsed.agent, parsed.version);
+            return await downloadAgent(resolved, org, parsed.agent, parsed.version, workspaceId);
         }
         catch (err) {
             const agentMeta = await (0, api_1.getPublicAgent)(resolved, org, parsed.agent, parsed.version);

package/dist/commands/schedule.js

@@ -143,8 +143,8 @@ function registerScheduleCommand(program) {
         }
         const workspaceId = await resolveWorkspaceId(config, options.workspace);
         const ref = (0, agent_ref_1.parseAgentRef)(agentArg);
-        // Resolve agent to get the ID
-        const agent = await (0, api_2.getAgentWithFallback)(config, ref.org, ref.agent, ref.version);
+        // Resolve agent to get the ID (pass workspace context for private agents)
+        const agent = await (0, api_2.getAgentWithFallback)(config, ref.org, ref.agent, ref.version, workspaceId);
         // Parse input data
         let inputData;
         if (options.input) {

package/dist/commands/service.js

@@ -93,9 +93,10 @@ function registerServiceCommand(program) {
         .option('--command <cmd>', 'Override entrypoint command')
         .option('--arg <value>', 'Command argument (repeatable)', collectArray, [])
         .option('--pin', 'Pin to deployed version (disable auto-update on publish)')
+        .option('--profile <name>', 'Use API key from named profile')
         .option('--json', 'Output as JSON')
         .action(async (agentArg, options) => {
-        const config = await (0, config_1.getResolvedConfig)();
+        const config = await (0, config_1.getResolvedConfig)({}, options.profile);
         if (!config.apiKey) {
             throw new errors_1.CliError('Missing API key. Run `orch login` first.');
         }

package/dist/commands/templates/support-agent.js

@@ -0,0 +1,570 @@
+"use strict";
+/**
+ * Multi-Platform Support Agent template.
+ *
+ * Generates a three-tier support agent that connects to Discord, Telegram,
+ * and/or Slack based on which tokens are configured.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SA_ENV_EXAMPLE = exports.SA_FAQ_MD = exports.SA_OVERVIEW_MD = exports.SA_REQUIREMENTS = exports.SA_MAIN_PY = exports.SA_SLACK_CONNECTOR_PY = exports.SA_TELEGRAM_CONNECTOR_PY = exports.SA_DISCORD_CONNECTOR_PY = exports.SA_BRAIN_PY = exports.SA_CONFIG_PY = void 0;
+exports.SA_CONFIG_PY = `"""
+Support Agent Configuration — Edit these 4 fields to customize your agent.
+"""
+
+# The name your bot uses when responding
+BOT_NAME = "Support Agent"
+
+# Your product/service name — used in prompts and classification
+PRODUCT_NAME = "My Product"
+
+# One-sentence description — helps the classifier understand your domain
+PRODUCT_DESCRIPTION = "a platform for doing amazing things"
+
+# Knowledge files used for the FAQ tier (general questions).
+FAQ_FILES = ["00-overview.md", "99-faq.md"]
+`;
+exports.SA_BRAIN_PY = `"""
+Support Agent Brain — Three-Tier Architecture
+
+Tier 1: CLASSIFY  — Haiku classifier decides if/how to respond
+Tier 2: FAQ       — General knowledge handles ~80% of questions (cached)
+Tier 3: DEEP DOCS — Topic-specific docs for detailed questions (cached per topic)
+"""
+
+import json
+import logging
+import os
+import sys
+from pathlib import Path
+
+import anthropic
+
+from config import BOT_NAME, FAQ_FILES, PRODUCT_DESCRIPTION, PRODUCT_NAME
+
+logger = logging.getLogger("support-agent.brain")
+
+CLASSIFY_MODEL = os.environ.get("CLASSIFY_MODEL", "claude-haiku-4-5-20251001")
+RESPOND_MODEL = os.environ.get("RESPOND_MODEL", "claude-sonnet-4-5-20250929")
+CLASSIFY_MAX_TOKENS = 150
+RESPOND_MAX_TOKENS = int(os.environ.get("MAX_TOKENS", "1024"))
+
+DOCS_DIR = Path(__file__).parent / "knowledge"
+
+
+def load_doc_files() -> dict[str, str]:
+    docs: dict[str, str] = {}
+    if not DOCS_DIR.is_dir():
+        logger.warning("knowledge/ directory not found")
+        return docs
+    for md_file in sorted(DOCS_DIR.glob("*.md")):
+        content = md_file.read_text(encoding="utf-8").strip()
+        if content:
+            docs[md_file.name] = content
+    logger.info("Loaded %d knowledge files", len(docs))
+    return docs
+
+
+def discover_topics(doc_files: dict[str, str]) -> dict[str, list[str]]:
+    topics: dict[str, list[str]] = {}
+    faq_set = set(FAQ_FILES)
+    for filename in sorted(doc_files.keys()):
+        if filename in faq_set:
+            continue
+        stem = filename.rsplit(".", 1)[0]
+        parts = stem.split("-", 1)
+        if len(parts) == 2 and parts[0].isdigit():
+            topic = parts[1]
+        else:
+            topic = stem
+        topic = topic.strip().lower().replace(" ", "-").replace("_", "-")
+        if not topic:
+            continue
+        topics.setdefault(topic, []).append(filename)
+    return topics
+
+
+def build_docs_context(doc_files: dict[str, str], filenames: list[str]) -> str:
+    parts: list[str] = []
+    for name in filenames:
+        if name in doc_files:
+            title = name.rsplit(".", 1)[0].replace("-", " ").title()
+            parts.append(f"## {title}\\n\\n{doc_files[name]}")
+    return "\\n\\n---\\n\\n".join(parts)
+
+
+def get_deep_files(topics: list[str], topic_files: dict[str, list[str]]) -> list[str]:
+    files: list[str] = []
+    seen: set[str] = set()
+    for topic in topics:
+        for f in topic_files.get(topic, []):
+            if f not in seen:
+                files.append(f)
+                seen.add(f)
+    for f in FAQ_FILES:
+        if f not in seen:
+            files.append(f)
+            seen.add(f)
+    return files
+
+
+def build_response_rules() -> str:
+    return f"""\\
+You are {BOT_NAME}, the official support assistant for {PRODUCT_NAME}.
+
+Your job is to answer user questions about {PRODUCT_NAME} accurately and helpfully, grounded in the documentation provided below. Follow these rules:
+
+1. Base your answers ONLY on the documentation below. Do not guess or make up features.
+2. Be concise and direct. Messages should be readable, not walls of text.
+3. Use code blocks for commands and code examples.
+4. If the documentation doesn't cover the question, say: "I'm not sure about this — a human will follow up." Do NOT hallucinate an answer.
+5. If a question is ambiguous, ask for clarification before answering.
+6. Be friendly and professional. You represent the {PRODUCT_NAME} team.
+7. Do not discuss pricing specifics beyond what's in the docs.
+8. Do not share internal implementation details, architecture decisions, or roadmap items.
+9. Keep responses under 1800 characters to stay readable.
+
+---
+
+# {PRODUCT_NAME} Documentation
+
+"""
+
+
+def build_classify_system_prompt(topic_list: list[str]) -> str:
+    topic_csv = ", ".join(topic_list) if topic_list else "general"
+    return f"""\\
+You are a message classifier for the {PRODUCT_NAME} support channel.
+{PRODUCT_NAME} is {PRODUCT_DESCRIPTION}.
+
+Classify the user's message. Return ONLY valid JSON, no other text.
+
+Topics: {topic_csv}
+
+{{"respond": bool, "tier": "faq" or "deep", "topics": ["topic1"]}}
+
+Rules:
+- "respond": false for greetings, thanks, off-topic chat, non-questions, emoji, memes
+- "tier": "faq" for simple/general questions about the platform
+- "tier": "deep" for questions needing specific technical details
+- "topics": 1-2 relevant topics when tier is "deep", empty list for "faq" """
+
+
+def build_faq_prompt(doc_files: dict[str, str]) -> str:
+    return build_response_rules() + build_docs_context(doc_files, FAQ_FILES)
+
+
+def build_deep_prompt(doc_files: dict[str, str], topics: list[str], topic_files: dict[str, list[str]]) -> str:
+    files = get_deep_files(topics, topic_files)
+    return build_response_rules() + build_docs_context(doc_files, files)
+
+
+def create_anthropic_client() -> anthropic.Anthropic:
+    api_key = os.environ.get("ANTHROPIC_API_KEY", "")
+    if not api_key:
+        logger.error("ANTHROPIC_API_KEY not set")
+        sys.exit(1)
+    return anthropic.Anthropic(api_key=api_key)
+
+
+def classify_message(client: anthropic.Anthropic, user_message: str, system_prompt: str) -> dict:
+    try:
+        response = client.messages.create(
+            model=CLASSIFY_MODEL, max_tokens=CLASSIFY_MAX_TOKENS,
+            system=system_prompt, messages=[{"role": "user", "content": user_message}],
+        )
+        raw = response.content[0].text.strip()
+        if raw.startswith("\\\`\\\`\\\`"):
+            raw = raw.split("\\n", 1)[1].rsplit("\\\`\\\`\\\`", 1)[0].strip()
+        result = json.loads(raw)
+        logger.info("Classify: respond=%s tier=%s topics=%s (in=%d out=%d)",
+            result.get("respond"), result.get("tier"), result.get("topics"),
+            response.usage.input_tokens, response.usage.output_tokens)
+        return result
+    except (json.JSONDecodeError, KeyError, IndexError) as exc:
+        logger.warning("Classifier returned invalid JSON: %s", exc)
+        return {"respond": True, "tier": "faq", "topics": []}
+    except anthropic.APIError as exc:
+        logger.warning("Classifier API error: %s", exc)
+        return {"respond": True, "tier": "faq", "topics": []}
+
+
+def query_llm(client: anthropic.Anthropic, system_prompt: str, user_message: str) -> tuple[str, int, int]:
+    response = client.messages.create(
+        model=RESPOND_MODEL, max_tokens=RESPOND_MAX_TOKENS,
+        system=[{"type": "text", "text": system_prompt, "cache_control": {"type": "ephemeral"}}],
+        messages=[{"role": "user", "content": user_message}],
+    )
+    return response.content[0].text, response.usage.input_tokens, response.usage.output_tokens
+
+
+class Brain:
+    def __init__(self, anthropic_client, doc_files, topic_files, faq_prompt, classify_system_prompt):
+        self.client = anthropic_client
+        self.doc_files = doc_files
+        self.topic_files = topic_files
+        self.faq_prompt = faq_prompt
+        self.classify_system_prompt = classify_system_prompt
+
+    def classify(self, message: str) -> dict:
+        return classify_message(self.client, message, self.classify_system_prompt)
+
+    def respond_faq(self, message: str) -> tuple[str, int, int]:
+        return query_llm(self.client, self.faq_prompt, message)
+
+    def respond_deep(self, message: str, topics: list[str]) -> tuple[str, int, int]:
+        prompt = build_deep_prompt(self.doc_files, topics, self.topic_files)
+        return query_llm(self.client, prompt, message)
+`;
+exports.SA_DISCORD_CONNECTOR_PY = `"""Discord connector for the support agent."""
+
+import asyncio
+import logging
+import os
+import time
+
+import anthropic
+import discord
+
+from brain import Brain
+
+logger = logging.getLogger("support-agent.discord")
+USER_COOLDOWN_SECONDS = int(os.environ.get("USER_COOLDOWN_SECONDS", "5"))
+
+
+def parse_channel_ids(raw: str) -> set[int]:
+    ids: set[int] = set()
+    for part in raw.split(","):
+        part = part.strip()
+        if part.isdigit():
+            ids.add(int(part))
+    return ids
+
+
+def should_respond(message: discord.Message, allowed_channels: set[int]) -> bool:
+    if message.author.bot:
+        return False
+    channel_id = message.channel.id
+    parent_id = getattr(message.channel, "parent_id", None)
+    if channel_id not in allowed_channels and parent_id not in allowed_channels:
+        return False
+    if not message.content or not message.content.strip():
+        return False
+    if len(message.content.strip()) < 5:
+        return False
+    return True
+
+
+class DiscordConnector(discord.Client):
+    def __init__(self, brain: Brain, allowed_channels: set[int]):
+        intents = discord.Intents.default()
+        intents.message_content = True
+        super().__init__(intents=intents)
+        self.brain = brain
+        self.allowed_channels = allowed_channels
+        self._user_last_response: dict[int, float] = {}
+
+    async def on_ready(self) -> None:
+        logger.info("Discord connected as %s (id=%s)", self.user, self.user.id)
+
+    async def on_message(self, message: discord.Message) -> None:
+        if not should_respond(message, self.allowed_channels):
+            return
+        now = time.time()
+        if now - self._user_last_response.get(message.author.id, 0) < USER_COOLDOWN_SECONDS:
+            return
+        user_text = message.content.strip()
+        classification = await asyncio.to_thread(self.brain.classify, user_text)
+        if not classification.get("respond", True):
+            return
+        tier = classification.get("tier", "faq")
+        topics = classification.get("topics", [])
+        try:
+            thread = await message.create_thread(name="Q: " + user_text[:80], auto_archive_duration=60)
+        except discord.HTTPException:
+            thread = message.channel
+        async with thread.typing():
+            try:
+                if tier == "deep" and topics:
+                    answer, _, _ = await asyncio.to_thread(self.brain.respond_deep, user_text, topics)
+                else:
+                    answer, _, _ = await asyncio.to_thread(self.brain.respond_faq, user_text)
+            except anthropic.RateLimitError:
+                await thread.send("I'm getting a lot of questions right now. Please try again in a minute.")
+                return
+            except anthropic.APITimeoutError:
+                await thread.send("My response timed out. Please try again.")
+                return
+            except anthropic.APIError:
+                await thread.send("I ran into an issue generating a response. A human will follow up.")
+                return
+        if len(answer) > 1900:
+            answer = answer[:1897] + "..."
+        await thread.send(answer)
+        self._user_last_response[message.author.id] = time.time()
+
+    async def run_async(self, token: str) -> None:
+        await self.start(token)
+`;
+exports.SA_TELEGRAM_CONNECTOR_PY = `"""Telegram connector for the support agent."""
+
+import asyncio
+import logging
+import os
+import time
+
+from telegram import Update
+from telegram.ext import Application, ContextTypes, MessageHandler, filters
+
+from brain import Brain
+
+logger = logging.getLogger("support-agent.telegram")
+USER_COOLDOWN_SECONDS = int(os.environ.get("USER_COOLDOWN_SECONDS", "5"))
+
+
+class TelegramConnector:
+    def __init__(self, brain: Brain, token: str):
+        self.brain = brain
+        self.token = token
+        self._user_last_response: dict[int, float] = {}
+
+    async def _handle_message(self, update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+        message = update.message
+        if not message or not message.text:
+            return
+        user_text = message.text.strip()
+        if len(user_text) < 5:
+            return
+        user_id = message.from_user.id if message.from_user else 0
+        now = time.time()
+        if now - self._user_last_response.get(user_id, 0) < USER_COOLDOWN_SECONDS:
+            return
+        classification = await asyncio.to_thread(self.brain.classify, user_text)
+        if not classification.get("respond", True):
+            return
+        tier = classification.get("tier", "faq")
+        topics = classification.get("topics", [])
+        await message.chat.send_action("typing")
+        try:
+            if tier == "deep" and topics:
+                answer, _, _ = await asyncio.to_thread(self.brain.respond_deep, user_text, topics)
+            else:
+                answer, _, _ = await asyncio.to_thread(self.brain.respond_faq, user_text)
+        except Exception:
+            await message.reply_text("I ran into an issue generating a response. A human will follow up.")
+            return
+        if len(answer) > 4000:
+            answer = answer[:3997] + "..."
+        await message.reply_text(answer)
+        self._user_last_response[user_id] = time.time()
+
+    async def run(self) -> None:
+        app = Application.builder().token(self.token).build()
+        app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, self._handle_message))
+        await app.initialize()
+        await app.start()
+        await app.updater.start_polling(drop_pending_updates=True)
+        try:
+            await asyncio.Event().wait()
+        finally:
+            await app.updater.stop()
+            await app.stop()
+            await app.shutdown()
+`;
+exports.SA_SLACK_CONNECTOR_PY = `"""Slack connector for the support agent (Socket Mode)."""
+
+import asyncio
+import logging
+import os
+import time
+
+from slack_bolt.adapter.socket_mode.async_handler import AsyncSocketModeHandler
+from slack_bolt.async_app import AsyncApp
+
+from brain import Brain
+
+logger = logging.getLogger("support-agent.slack")
+USER_COOLDOWN_SECONDS = int(os.environ.get("USER_COOLDOWN_SECONDS", "5"))
+
+
+class SlackConnector:
+    def __init__(self, brain: Brain, bot_token: str, app_token: str):
+        self.brain = brain
+        self.app = AsyncApp(token=bot_token)
+        self.app_token = app_token
+        self._user_last_response: dict[str, float] = {}
+        self._register_handlers()
+
+    def _register_handlers(self) -> None:
+        @self.app.event("message")
+        async def handle_message(event, say):
+            if event.get("bot_id") or event.get("subtype"):
+                return
+            text = event.get("text", "").strip()
+            if not text or len(text) < 5:
+                return
+            user_id = event.get("user", "unknown")
+            now = time.time()
+            if now - self._user_last_response.get(user_id, 0) < USER_COOLDOWN_SECONDS:
+                return
+            classification = await asyncio.to_thread(self.brain.classify, text)
+            if not classification.get("respond", True):
+                return
+            tier = classification.get("tier", "faq")
+            topics = classification.get("topics", [])
+            try:
+                if tier == "deep" and topics:
+                    answer, _, _ = await asyncio.to_thread(self.brain.respond_deep, text, topics)
+                else:
+                    answer, _, _ = await asyncio.to_thread(self.brain.respond_faq, text)
+            except Exception:
+                await say("I ran into an issue generating a response. A human will follow up.")
+                return
+            if len(answer) > 3000:
+                answer = answer[:2997] + "..."
+            await say(answer, thread_ts=event.get("ts"))
+            self._user_last_response[user_id] = time.time()
+
+    async def run(self) -> None:
+        handler = AsyncSocketModeHandler(self.app, self.app_token)
+        await handler.start_async()
+`;
+exports.SA_MAIN_PY = `"""
+Multi-Platform Support Agent — Startup Orchestrator
+
+Checks which platform tokens are configured and starts those connectors.
+"""
+
+import asyncio
+import logging
+import os
+import sys
+
+from brain import (Brain, build_classify_system_prompt, build_faq_prompt,
+                   create_anthropic_client, discover_topics, load_doc_files)
+from config import FAQ_FILES
+
+LOG_LEVEL = os.environ.get("LOG_LEVEL", "INFO").upper()
+logging.basicConfig(level=getattr(logging, LOG_LEVEL, logging.INFO),
+                    format="%(asctime)s %(levelname)s %(name)s: %(message)s", stream=sys.stdout)
+logger = logging.getLogger("support-agent")
+
+
+def validate_knowledge(doc_files: dict[str, str]) -> None:
+    if not doc_files:
+        logger.error("No knowledge files found in knowledge/ directory")
+        sys.exit(1)
+    for faq_file in FAQ_FILES:
+        if faq_file not in doc_files:
+            logger.error("FAQ file '%s' not found in knowledge/", faq_file)
+            sys.exit(1)
+
+
+async def run_connectors(brain: Brain) -> None:
+    tasks = []
+    active = []
+
+    discord_token = os.environ.get("DISCORD_BOT_TOKEN", "")
+    if discord_token:
+        from connectors.discord_connector import DiscordConnector, parse_channel_ids
+        channels_raw = os.environ.get("DISCORD_CHANNEL_IDS", "")
+        if not channels_raw:
+            logger.error("DISCORD_BOT_TOKEN set but DISCORD_CHANNEL_IDS missing")
+            sys.exit(1)
+        channels = parse_channel_ids(channels_raw)
+        if not channels:
+            logger.error("No valid channel IDs in DISCORD_CHANNEL_IDS")
+            sys.exit(1)
+        tasks.append(DiscordConnector(brain, channels).run_async(discord_token))
+        active.append("Discord")
+
+    telegram_token = os.environ.get("TELEGRAM_BOT_TOKEN", "")
+    if telegram_token:
+        from connectors.telegram_connector import TelegramConnector
+        tasks.append(TelegramConnector(brain, telegram_token).run())
+        active.append("Telegram")
+
+    slack_bot_token = os.environ.get("SLACK_BOT_TOKEN", "")
+    if slack_bot_token:
+        from connectors.slack_connector import SlackConnector
+        slack_app_token = os.environ.get("SLACK_APP_TOKEN", "")
+        if not slack_app_token:
+            logger.error("SLACK_BOT_TOKEN set but SLACK_APP_TOKEN missing")
+            sys.exit(1)
+        tasks.append(SlackConnector(brain, slack_bot_token, slack_app_token).run())
+        active.append("Slack")
+
+    if not tasks:
+        logger.error("No platform tokens configured. Set at least one of: DISCORD_BOT_TOKEN, TELEGRAM_BOT_TOKEN, SLACK_BOT_TOKEN")
+        sys.exit(1)
+
+    logger.info("Active platforms: %s", ", ".join(active))
+    await asyncio.gather(*tasks)
+
+
+def main() -> None:
+    if not os.environ.get("ANTHROPIC_API_KEY"):
+        logger.error("ANTHROPIC_API_KEY not set")
+        sys.exit(1)
+
+    doc_files = load_doc_files()
+    validate_knowledge(doc_files)
+
+    topic_files = discover_topics(doc_files)
+    topic_list = sorted(topic_files.keys())
+    faq_prompt = build_faq_prompt(doc_files)
+    classify_prompt = build_classify_system_prompt(topic_list)
+
+    logger.info("Topics discovered: %s", topic_list)
+
+    brain = Brain(
+        anthropic_client=create_anthropic_client(),
+        doc_files=doc_files, topic_files=topic_files,
+        faq_prompt=faq_prompt, classify_system_prompt=classify_prompt,
+    )
+
+    logger.info("Starting Multi-Platform Support Agent")
+    asyncio.run(run_connectors(brain))
+
+
+if __name__ == "__main__":
+    main()
+`;
+exports.SA_REQUIREMENTS = `discord.py>=2.3.0,<3.0.0
+python-telegram-bot>=21.0,<22.0.0
+slack-bolt>=1.18.0,<2.0.0
+anthropic>=0.40.0,<1.0.0
+`;
+exports.SA_OVERVIEW_MD = `# My Product Overview
+
+Welcome to My Product! This is a placeholder overview document.
+
+Replace this file with your own product overview and FAQ-tier knowledge.
+
+## Getting Started
+
+1. Sign up at myproduct.com
+2. Follow the quick start guide
+3. Start building
+`;
+exports.SA_FAQ_MD = `# FAQ
+
+**Q: What is My Product?**
+A: My Product is a platform for doing amazing things. Replace this with your actual FAQ.
+
+**Q: How do I get help?**
+A: Ask in the support channel — our support agent will respond!
+`;
+exports.SA_ENV_EXAMPLE = `# Required — auto-injected in production via supported_providers
+ANTHROPIC_API_KEY=
+
+# --- Discord (optional) ---
+DISCORD_BOT_TOKEN=
+DISCORD_CHANNEL_IDS=
+
+# --- Telegram (optional) ---
+TELEGRAM_BOT_TOKEN=
+
+# --- Slack (optional) ---
+SLACK_BOT_TOKEN=
+SLACK_APP_TOKEN=
+`;

package/dist/lib/api.js

@@ -51,6 +51,7 @@ exports.downloadCodeBundle = downloadCodeBundle;
 exports.uploadCodeBundle = uploadCodeBundle;
 exports.getMyAgent = getMyAgent;
 exports.getAgentWithFallback = getAgentWithFallback;
+exports.resolveWorkspaceIdForOrg = resolveWorkspaceIdForOrg;
 exports.downloadCodeBundleAuthenticated = downloadCodeBundleAuthenticated;
 exports.checkAgentDelete = checkAgentDelete;
 exports.deleteAgent = deleteAgent;
@@ -290,8 +291,11 @@ async function updateOrg(config, payload) {
 async function getPublicAgent(config, org, agent, version) {
     return publicRequest(config, `/public/agents/${org}/${agent}/${version}`);
 }
-async function listMyAgents(config) {
-    return request(config, 'GET', '/agents');
+async function listMyAgents(config, workspaceId) {
+    const headers = {};
+    if (workspaceId)
+        headers['X-Workspace-Id'] = workspaceId;
+    return request(config, 'GET', '/agents', { headers });
 }
 async function createAgent(config, data, workspaceId) {
     const headers = { 'Content-Type': 'application/json' };
@@ -320,7 +324,7 @@ async function downloadCodeBundle(config, org, agent, version) {
 /**
  * Upload a code bundle for a hosted tool agent.
  */
-async function uploadCodeBundle(config, agentId, bundlePath, entrypoint) {
+async function uploadCodeBundle(config, agentId, bundlePath, entrypoint, workspaceId) {
     if (!config.apiKey) {
         throw new ApiError('Missing API key. Run `orchagent login` first.', 401);
     }
@@ -338,6 +342,9 @@ async function uploadCodeBundle(config, agentId, bundlePath, entrypoint) {
     if (entrypoint) {
         headers['x-entrypoint'] = entrypoint;
     }
+    if (workspaceId) {
+        headers['X-Workspace-Id'] = workspaceId;
+    }
     const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/upload`, {
         method: 'POST',
         headers,
@@ -351,8 +358,8 @@ async function uploadCodeBundle(config, agentId, bundlePath, entrypoint) {
 /**
  * Get single agent by name/version from authenticated endpoint.
  */
-async function getMyAgent(config, agentName, version) {
-    const agents = await listMyAgents(config);
+async function getMyAgent(config, agentName, version, workspaceId) {
+    const agents = await listMyAgents(config, workspaceId);
     const matching = agents.filter(a => a.name === agentName);
     if (matching.length === 0)
         return null;
@@ -364,7 +371,7 @@ async function getMyAgent(config, agentName, version) {
 /**
  * Try public endpoint first, fallback to authenticated for private agents.
  */
-async function getAgentWithFallback(config, org, agentName, version) {
+async function getAgentWithFallback(config, org, agentName, version, workspaceId) {
     try {
         return await getPublicAgent(config, org, agentName, version);
     }
@@ -375,16 +382,31 @@ async function getAgentWithFallback(config, org, agentName, version) {
     if (!config.apiKey) {
         throw new ApiError(`Agent '${org}/${agentName}@${version}' not found`, 404);
     }
-    const userOrg = await getOrg(config);
+    const userOrg = await getOrg(config, workspaceId);
     if (userOrg.slug !== org) {
         throw new ApiError(`Agent '${org}/${agentName}@${version}' not found`, 404);
     }
-    const myAgent = await getMyAgent(config, agentName, version);
+    const myAgent = await getMyAgent(config, agentName, version, workspaceId);
     if (!myAgent) {
         throw new ApiError(`Agent '${org}/${agentName}@${version}' not found`, 404);
     }
     return myAgent;
 }
+/**
+ * Resolve a workspace ID from an org slug.
+ * Returns undefined for personal orgs or if unauthenticated.
+ */
+async function resolveWorkspaceIdForOrg(config, orgSlug) {
+    if (!config.apiKey)
+        return undefined;
+    try {
+        const { workspaces } = await request(config, 'GET', '/workspaces');
+        return workspaces.find(w => w.slug === orgSlug)?.id;
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * Download a tool bundle for a private agent using authenticated endpoint.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.3.67",
+  "version": "0.3.69",
   "description": "Command-line interface for orchagent — deploy and run AI agents for your team",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",