@kalphq/cli 0.0.0-dev-20260416055233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/dist/agents/b2b-sales/signals/.gitkeep +0 -0
  2. package/dist/agents/b2b-sales/webhooks/.gitkeep +0 -0
  3. package/dist/agents/customer-support/signals/.gitkeep +0 -0
  4. package/dist/agents/customer-support/webhooks/.gitkeep +0 -0
  5. package/dist/agents/financial-agent/signals/.gitkeep +0 -0
  6. package/dist/agents/financial-agent/webhooks/.gitkeep +0 -0
  7. package/dist/agents/minimal/signals/.gitkeep +0 -0
  8. package/dist/agents/minimal/webhooks/.gitkeep +0 -0
  9. package/dist/build-ZMN2247N.js +121 -0
  10. package/dist/build-ZMN2247N.js.map +1 -0
  11. package/dist/chunk-VMU456Z7.js +109 -0
  12. package/dist/chunk-VMU456Z7.js.map +1 -0
  13. package/dist/create-VKJ6C6DZ.js +118 -0
  14. package/dist/create-VKJ6C6DZ.js.map +1 -0
  15. package/dist/index.js +18 -0
  16. package/dist/index.js.map +1 -0
  17. package/dist/init-5UAVM2WR.js +74 -0
  18. package/dist/init-5UAVM2WR.js.map +1 -0
  19. package/dist/templates/agents/b2b-sales/signals/.gitkeep +0 -0
  20. package/dist/templates/agents/b2b-sales/webhooks/.gitkeep +0 -0
  21. package/dist/templates/agents/customer-support/signals/.gitkeep +0 -0
  22. package/dist/templates/agents/customer-support/webhooks/.gitkeep +0 -0
  23. package/dist/templates/agents/financial-agent/signals/.gitkeep +0 -0
  24. package/dist/templates/agents/financial-agent/webhooks/.gitkeep +0 -0
  25. package/dist/templates/agents/minimal/signals/.gitkeep +0 -0
  26. package/dist/templates/agents/minimal/webhooks/.gitkeep +0 -0
  27. package/package.json +39 -0
  28. package/templates/agents/b2b-sales/index.ts +28 -0
  29. package/templates/agents/b2b-sales/signals/.gitkeep +0 -0
  30. package/templates/agents/b2b-sales/steps/score-lead.ts +24 -0
  31. package/templates/agents/b2b-sales/tools/enrich-company.ts +17 -0
  32. package/templates/agents/b2b-sales/webhooks/.gitkeep +0 -0
  33. package/templates/agents/customer-support/index.ts +28 -0
  34. package/templates/agents/customer-support/signals/.gitkeep +0 -0
  35. package/templates/agents/customer-support/steps/classify-ticket.ts +22 -0
  36. package/templates/agents/customer-support/tools/search-kb.ts +13 -0
  37. package/templates/agents/customer-support/webhooks/.gitkeep +0 -0
  38. package/templates/agents/financial-agent/index.ts +28 -0
  39. package/templates/agents/financial-agent/signals/.gitkeep +0 -0
  40. package/templates/agents/financial-agent/steps/analyze-signal.ts +26 -0
  41. package/templates/agents/financial-agent/tools/fetch-market-data.ts +13 -0
  42. package/templates/agents/financial-agent/webhooks/.gitkeep +0 -0
  43. package/templates/agents/minimal/index.ts +16 -0
  44. package/templates/agents/minimal/signals/.gitkeep +0 -0
  45. package/templates/agents/minimal/steps/example-step.ts +13 -0
  46. package/templates/agents/minimal/tools/example-tool.ts +13 -0
  47. package/templates/agents/minimal/webhooks/.gitkeep +0 -0
  48. package/templates/project/meta/deployed.json +1 -0
  49. package/templates/project/package.json +13 -0
  50. package/templates/project/tsconfig.json +14 -0
  51. package/templates/project-root/package.json +9 -0
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
@@ -0,0 +1,121 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/commands/build.ts
4
+ import { defineCommand } from "citty";
5
+ import * as p from "@clack/prompts";
6
+ import pc from "picocolors";
7
+ import { readFile } from "fs/promises";
8
+ import { resolve as resolve2, relative } from "path";
9
+ import { z } from "zod";
10
+ import * as esbuild from "esbuild";
11
+
12
+ // src/commands/utils.ts
13
+ import { readdir, stat } from "fs/promises";
14
+ import { resolve, dirname } from "path";
15
+ async function glob(pattern) {
16
+ const dir = dirname(dirname(pattern));
17
+ const filename = pattern.split("/").pop() ?? pattern.split("\\").pop() ?? "";
18
+ const results = [];
19
+ try {
20
+ const entries = await readdir(dir, { withFileTypes: true });
21
+ for (const entry of entries) {
22
+ if (!entry.isDirectory()) continue;
23
+ const candidate = resolve(dir, entry.name, filename);
24
+ try {
25
+ const s = await stat(candidate);
26
+ if (s.isFile()) results.push(candidate);
27
+ } catch {
28
+ }
29
+ }
30
+ } catch {
31
+ }
32
+ return results;
33
+ }
34
+
35
+ // src/commands/build.ts
36
+ var LOGO = "\u{1F98B}";
37
+ var build_default = defineCommand({
38
+ meta: { name: "build", description: "Bundle agents for deployment" },
39
+ async run() {
40
+ await _build();
41
+ }
42
+ });
43
+ var KalpConfigSchema = z.object({
44
+ projectId: z.string().min(1),
45
+ region: z.string().optional(),
46
+ secrets: z.array(z.string()).optional()
47
+ });
48
+ async function _build() {
49
+ p.intro(`${LOGO} ${pc.bold("kalp build")}`);
50
+ const cwd = process.cwd();
51
+ const configPath = resolve2(cwd, "kalp.config.ts");
52
+ const s = p.spinner();
53
+ s.start("Reading kalp.config.ts");
54
+ let configRaw = "";
55
+ try {
56
+ configRaw = await readFile(configPath, "utf-8");
57
+ } catch {
58
+ s.stop(pc.red("kalp.config.ts not found"));
59
+ p.outro(`${pc.dim("Run")} ${pc.cyan("kalp init")} ${pc.dim("first.")}`);
60
+ process.exit(1);
61
+ }
62
+ const match = configRaw.match(/defineConfig\(\s*(\{[\s\S]*?\})\s*\)/);
63
+ if (!match?.[1]) {
64
+ s.stop(pc.red("Could not parse kalp.config.ts"));
65
+ process.exit(1);
66
+ }
67
+ let parsed;
68
+ try {
69
+ const fn = new Function(`return ${match[1]}`);
70
+ parsed = KalpConfigSchema.parse(fn());
71
+ } catch (err) {
72
+ s.stop(pc.red("Invalid kalp.config.ts"));
73
+ if (err instanceof z.ZodError) {
74
+ for (const issue of err.issues) {
75
+ p.log.error(` ${issue.path.join(".")}: ${issue.message}`);
76
+ }
77
+ }
78
+ process.exit(1);
79
+ }
80
+ s.stop(`Project ${pc.cyan(parsed.projectId)} validated`);
81
+ s.start("Discovering agents");
82
+ const agentEntries = await glob(resolve2(cwd, "kalp/agents/*/index.ts"));
83
+ if (agentEntries.length === 0) {
84
+ s.stop(pc.yellow("No agents found in kalp/agents/"));
85
+ p.outro(pc.dim("Create an agent first."));
86
+ process.exit(0);
87
+ }
88
+ s.stop(`Found ${pc.cyan(String(agentEntries.length))} agent(s)`);
89
+ s.start("Bundling agents");
90
+ const outdir = resolve2(cwd, "kalp/meta/dist");
91
+ try {
92
+ await esbuild.build({
93
+ entryPoints: agentEntries,
94
+ bundle: true,
95
+ platform: "node",
96
+ target: "es2022",
97
+ format: "esm",
98
+ outdir,
99
+ minify: true,
100
+ treeShaking: true,
101
+ external: ["@kalphq/sdk"],
102
+ logLevel: "silent"
103
+ });
104
+ } catch (err) {
105
+ s.stop(pc.red("Build failed"));
106
+ console.error(err);
107
+ process.exit(1);
108
+ }
109
+ s.stop("Bundle ready");
110
+ const lines = agentEntries.map(
111
+ (e) => ` ${pc.dim("\u2022")} ${pc.cyan(relative(cwd, e))}`
112
+ );
113
+ p.note(lines.join("\n"), "Bundled agents");
114
+ p.outro(
115
+ `${LOGO} ${pc.green("Build complete.")} ${pc.dim(`Output \u2192 kalp/meta/dist/`)}`
116
+ );
117
+ }
118
+ export {
119
+ build_default as default
120
+ };
121
+ //# sourceMappingURL=build-ZMN2247N.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/build.ts","../src/commands/utils.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { readFile } from \"node:fs/promises\";\nimport { resolve, relative } from \"node:path\";\nimport { z } from \"zod\";\nimport * as esbuild from \"esbuild\";\nimport { glob } from \"./utils.js\";\n\nconst LOGO = \"🦋\";\n\nexport default defineCommand({\n meta: { name: \"build\", description: \"Bundle agents for deployment\" },\n async run() {\n await _build();\n },\n});\n\nconst KalpConfigSchema = z.object({\n projectId: z.string().min(1),\n region: z.string().optional(),\n secrets: z.array(z.string()).optional(),\n});\n\nasync function _build(): Promise<void> {\n p.intro(`${LOGO} ${pc.bold(\"kalp build\")}`);\n\n const cwd = process.cwd();\n const configPath = resolve(cwd, \"kalp.config.ts\");\n\n // ── Validate kalp.config.ts ────────────────────────────────────────────\n const s = p.spinner();\n s.start(\"Reading kalp.config.ts\");\n\n let configRaw = \"\";\n try {\n configRaw = await readFile(configPath, \"utf-8\");\n } catch {\n s.stop(pc.red(\"kalp.config.ts not found\"));\n p.outro(`${pc.dim(\"Run\")} ${pc.cyan(\"kalp init\")} ${pc.dim(\"first.\")}`);\n process.exit(1);\n }\n\n // Extract the config object from defineConfig({...}) using a lightweight regex\n const match = configRaw.match(/defineConfig\\(\\s*(\\{[\\s\\S]*?\\})\\s*\\)/);\n if (!match?.[1]) {\n s.stop(pc.red(\"Could not parse kalp.config.ts\"));\n process.exit(1);\n }\n\n let parsed: z.infer<typeof KalpConfigSchema>;\n try {\n // Evaluate the config object (safe: it's the user's own config file)\n const fn = new Function(`return ${match[1]}`);\n parsed = KalpConfigSchema.parse(fn());\n } catch (err) {\n s.stop(pc.red(\"Invalid kalp.config.ts\"));\n if (err instanceof z.ZodError) {\n for (const issue of err.issues) {\n p.log.error(` ${issue.path.join(\".\")}: ${issue.message}`);\n }\n }\n process.exit(1);\n }\n\n s.stop(`Project ${pc.cyan(parsed.projectId)} validated`);\n\n // ── Discover agent entry points ────────────────────────────────────────\n s.start(\"Discovering agents\");\n\n const agentEntries = await glob(resolve(cwd, \"kalp/agents/*/index.ts\"));\n if (agentEntries.length === 0) {\n s.stop(pc.yellow(\"No agents found in kalp/agents/\"));\n p.outro(pc.dim(\"Create an agent first.\"));\n process.exit(0);\n }\n\n s.stop(`Found ${pc.cyan(String(agentEntries.length))} agent(s)`);\n\n // ── Bundle with esbuild ────────────────────────────────────────────────\n s.start(\"Bundling agents\");\n\n const outdir = resolve(cwd, \"kalp/meta/dist\");\n try {\n await esbuild.build({\n entryPoints: agentEntries,\n bundle: true,\n platform: \"node\",\n target: \"es2022\",\n format: \"esm\",\n outdir,\n minify: true,\n treeShaking: true,\n external: [\"@kalphq/sdk\"],\n logLevel: \"silent\",\n });\n } catch (err) {\n s.stop(pc.red(\"Build failed\"));\n console.error(err);\n process.exit(1);\n }\n\n s.stop(\"Bundle ready\");\n\n // ── Summary ────────────────────────────────────────────────────────────\n const lines = agentEntries.map(\n (e: string) => ` ${pc.dim(\"•\")} ${pc.cyan(relative(cwd, e))}`,\n );\n p.note(lines.join(\"\\n\"), \"Bundled agents\");\n\n p.outro(\n `${LOGO} ${pc.green(\"Build complete.\")} ${pc.dim(`Output → kalp/meta/dist/`)}`,\n );\n}\n","import { readdir, stat } from \"node:fs/promises\";\nimport { resolve, dirname } from \"node:path\";\n\n/**\n * Minimal glob for patterns like `some/path/* /index.ts`.\n * Matches one directory level then a fixed filename.\n */\nexport async function glob(pattern: string): Promise<string[]> {\n const dir = dirname(dirname(pattern));\n const filename = pattern.split(\"/\").pop() ?? pattern.split(\"\\\\\").pop() ?? \"\";\n\n const results: string[] = [];\n\n try {\n const entries = await readdir(dir, { withFileTypes: true });\n for (const entry of entries) {\n if (!entry.isDirectory()) continue;\n const candidate = resolve(dir, entry.name, filename);\n try {\n const s = await stat(candidate);\n if (s.isFile()) results.push(candidate);\n } catch {\n // file doesn't exist in this subdirectory\n }\n }\n } catch {\n // parent directory doesn't exist\n }\n\n return results;\n}\n"],"mappings":"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","names":["resolve","resolve"]}
@@ -0,0 +1,109 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/templates/index.ts
4
+ var TEMPLATES = [
5
+ {
6
+ id: "customer-support",
7
+ label: "Customer Support",
8
+ hint: "ticket routing, escalation, knowledge base",
9
+ secrets: ["OPENAI_API_KEY"]
10
+ },
11
+ {
12
+ id: "b2b-sales",
13
+ label: "B2B Sales Outreach",
14
+ hint: "CRM enrichment, lead scoring",
15
+ secrets: ["OPENAI_API_KEY", "CRM_API_KEY"]
16
+ },
17
+ {
18
+ id: "financial-agent",
19
+ label: "Financial Agent",
20
+ hint: "market signals, portfolio analysis",
21
+ secrets: ["OPENAI_API_KEY", "MARKET_DATA_API_KEY"]
22
+ },
23
+ {
24
+ id: "minimal",
25
+ label: "Minimal Skeleton",
26
+ hint: "bare structure, start from scratch",
27
+ secrets: []
28
+ }
29
+ ];
30
+ function getTemplateMeta(id) {
31
+ return TEMPLATES.find((t) => t.id === id);
32
+ }
33
+
34
+ // src/scaffold.ts
35
+ import { writeFile, readFile, readdir, cp } from "fs/promises";
36
+ import { fileURLToPath } from "url";
37
+ import { join, dirname } from "path";
38
+ var __filename = fileURLToPath(import.meta.url);
39
+ var __dirname = dirname(__filename);
40
+ var TEMPLATES_DIR = join(__dirname, "..", "templates");
41
+ async function replacePlaceholders(dir, map) {
42
+ const entries = await readdir(dir, { withFileTypes: true });
43
+ for (const entry of entries) {
44
+ const fp = join(dir, entry.name);
45
+ if (entry.isDirectory()) {
46
+ await replacePlaceholders(fp, map);
47
+ } else if (entry.isFile() && entry.name !== ".gitkeep") {
48
+ try {
49
+ let src = await readFile(fp, "utf-8");
50
+ let changed = false;
51
+ for (const [from, to] of Object.entries(map)) {
52
+ if (src.includes(from)) {
53
+ src = src.replaceAll(from, to);
54
+ changed = true;
55
+ }
56
+ }
57
+ if (changed) await writeFile(fp, src, "utf-8");
58
+ } catch {
59
+ }
60
+ }
61
+ }
62
+ }
63
+ async function scaffoldProject(opts) {
64
+ const { projectName, cwd } = opts;
65
+ const kalpConfig = `import { defineConfig } from "@kalphq/sdk";
66
+
67
+ export default defineConfig({
68
+ projectId: "${projectName}",
69
+ secrets: [],
70
+ });
71
+ `;
72
+ await writeFile(join(cwd, "kalp.config.ts"), kalpConfig, "utf-8");
73
+ const kalpDir = join(cwd, "kalp");
74
+ await cp(join(TEMPLATES_DIR, "project"), kalpDir, {
75
+ recursive: true,
76
+ force: true
77
+ });
78
+ await replacePlaceholders(kalpDir, { __PROJECT_NAME__: projectName });
79
+ }
80
+ async function scaffoldAgent(opts) {
81
+ const { agentName, templateId, cwd } = opts;
82
+ const meta = getTemplateMeta(templateId);
83
+ const agentDir = join(cwd, "kalp", "agents", agentName);
84
+ await cp(join(TEMPLATES_DIR, "agents", templateId), agentDir, {
85
+ recursive: true,
86
+ force: true
87
+ });
88
+ await replacePlaceholders(agentDir, { __AGENT_NAME__: agentName });
89
+ if (meta.secrets.length > 0) {
90
+ const envPath = join(cwd, ".env");
91
+ let envExisting = "";
92
+ try {
93
+ envExisting = await readFile(envPath, "utf-8");
94
+ } catch {
95
+ }
96
+ const toAdd = meta.secrets.filter((s) => !envExisting.includes(s)).map((s) => `${s}=`).join("\n");
97
+ if (toAdd) {
98
+ const content = envExisting ? envExisting.trimEnd() + "\n" + toAdd + "\n" : toAdd + "\n";
99
+ await writeFile(envPath, content, "utf-8");
100
+ }
101
+ }
102
+ }
103
+
104
+ export {
105
+ TEMPLATES,
106
+ scaffoldProject,
107
+ scaffoldAgent
108
+ };
109
+ //# sourceMappingURL=chunk-VMU456Z7.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/templates/index.ts","../src/scaffold.ts"],"sourcesContent":["export type TemplateId =\n | \"customer-support\"\n | \"b2b-sales\"\n | \"financial-agent\"\n | \"minimal\";\n\nexport interface TemplateMeta {\n id: TemplateId;\n label: string;\n hint: string;\n secrets: string[];\n}\n\nexport const TEMPLATES: TemplateMeta[] = [\n {\n id: \"customer-support\",\n label: \"Customer Support\",\n hint: \"ticket routing, escalation, knowledge base\",\n secrets: [\"OPENAI_API_KEY\"],\n },\n {\n id: \"b2b-sales\",\n label: \"B2B Sales Outreach\",\n hint: \"CRM enrichment, lead scoring\",\n secrets: [\"OPENAI_API_KEY\", \"CRM_API_KEY\"],\n },\n {\n id: \"financial-agent\",\n label: \"Financial Agent\",\n hint: \"market signals, portfolio analysis\",\n secrets: [\"OPENAI_API_KEY\", \"MARKET_DATA_API_KEY\"],\n },\n {\n id: \"minimal\",\n label: \"Minimal Skeleton\",\n hint: \"bare structure, start from scratch\",\n secrets: [],\n },\n];\n\nexport function getTemplateMeta(id: TemplateId): TemplateMeta {\n return TEMPLATES.find((t) => t.id === id)!;\n}\n","import { writeFile, readFile, readdir, cp } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport { join, dirname } from \"node:path\";\nimport { getTemplateMeta, type TemplateId } from \"./templates/index.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nexport const TEMPLATES_DIR = join(__dirname, \"..\", \"templates\");\n\nasync function replacePlaceholders(\n dir: string,\n map: Record<string, string>,\n): Promise<void> {\n const entries = await readdir(dir, { withFileTypes: true });\n for (const entry of entries) {\n const fp = join(dir, entry.name);\n if (entry.isDirectory()) {\n await replacePlaceholders(fp, map);\n } else if (entry.isFile() && entry.name !== \".gitkeep\") {\n try {\n let src = await readFile(fp, \"utf-8\");\n let changed = false;\n for (const [from, to] of Object.entries(map)) {\n if (src.includes(from)) {\n src = src.replaceAll(from, to);\n changed = true;\n }\n }\n if (changed) await writeFile(fp, src, \"utf-8\");\n } catch {\n // binary file — skip\n }\n }\n }\n}\n\nexport async function scaffoldProject(opts: {\n projectName: string;\n cwd: string;\n}): Promise<void> {\n const { projectName, cwd } = opts;\n\n // ── kalp.config.ts at root ─────────────────────────────────────────────\n const kalpConfig = `import { defineConfig } from \"@kalphq/sdk\";\n\nexport default defineConfig({\n projectId: \"${projectName}\",\n secrets: [],\n});\n`;\n await writeFile(join(cwd, \"kalp.config.ts\"), kalpConfig, \"utf-8\");\n\n // ── kalp/ sub-package via fs.cp ───────────────────────────────────────\n const kalpDir = join(cwd, \"kalp\");\n await cp(join(TEMPLATES_DIR, \"project\"), kalpDir, {\n recursive: true,\n force: true,\n });\n await replacePlaceholders(kalpDir, { __PROJECT_NAME__: projectName });\n}\n\nexport async function scaffoldAgent(opts: {\n agentName: string;\n templateId: TemplateId;\n cwd: string;\n}): Promise<void> {\n const { agentName, templateId, cwd } = opts;\n const meta = getTemplateMeta(templateId);\n const agentDir = join(cwd, \"kalp\", \"agents\", agentName);\n\n // ── Agent files via fs.cp ─────────────────────────────────────────────\n await cp(join(TEMPLATES_DIR, \"agents\", templateId), agentDir, {\n recursive: true,\n force: true,\n });\n await replacePlaceholders(agentDir, { __AGENT_NAME__: agentName });\n\n // ── .env at root (append missing secrets) ─────────────────────────────\n if (meta.secrets.length > 0) {\n const envPath = join(cwd, \".env\");\n let envExisting = \"\";\n try {\n envExisting = await readFile(envPath, \"utf-8\");\n } catch {\n // doesn't exist yet\n }\n const toAdd = meta.secrets\n .filter((s) => !envExisting.includes(s))\n .map((s) => `${s}=`)\n .join(\"\\n\");\n if (toAdd) {\n const content = envExisting\n ? envExisting.trimEnd() + \"\\n\" + toAdd + \"\\n\"\n : toAdd + \"\\n\";\n await writeFile(envPath, content, \"utf-8\");\n }\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,118 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ TEMPLATES,
4
+ scaffoldAgent,
5
+ scaffoldProject
6
+ } from "./chunk-VMU456Z7.js";
7
+
8
+ // src/commands/create.ts
9
+ import { join } from "path";
10
+ import { access } from "fs/promises";
11
+ import { defineCommand } from "citty";
12
+ import * as p from "@clack/prompts";
13
+ import pc from "picocolors";
14
+ import { installDependencies, detectPackageManager } from "nypm";
15
+ var LOGO = "\u{1F98B}";
16
+ var create_default = defineCommand({
17
+ meta: { name: "create", description: "Add a new agent to the project" },
18
+ async run() {
19
+ const cwd = process.cwd();
20
+ p.intro(`${LOGO} ${pc.bold("kalp create")}`);
21
+ let needsInit = false;
22
+ try {
23
+ await access(join(cwd, "kalp.config.ts"));
24
+ } catch {
25
+ needsInit = true;
26
+ }
27
+ let projectName;
28
+ if (needsInit) {
29
+ p.log.warn(
30
+ `No ${pc.cyan("kalp.config.ts")} found \u2014 initializing project first.`
31
+ );
32
+ const initAnswers = await p.group(
33
+ {
34
+ name: () => p.text({
35
+ message: "Project name?",
36
+ placeholder: "my-project",
37
+ validate: (v) => {
38
+ if (!v.trim()) return "Project name is required.";
39
+ if (!/^[a-z0-9-]+$/.test(v))
40
+ return "Use lowercase letters, numbers, and dashes only.";
41
+ }
42
+ })
43
+ },
44
+ {
45
+ onCancel: () => {
46
+ p.cancel("Cancelled.");
47
+ process.exit(0);
48
+ }
49
+ }
50
+ );
51
+ projectName = initAnswers.name;
52
+ }
53
+ const agentAnswers = await p.group(
54
+ {
55
+ name: () => p.text({
56
+ message: "Agent name?",
57
+ placeholder: "my-agent",
58
+ validate: (v) => {
59
+ if (!v.trim()) return "Agent name is required.";
60
+ if (!/^[a-z0-9-]+$/.test(v))
61
+ return "Use lowercase letters, numbers, and dashes only.";
62
+ }
63
+ }),
64
+ template: () => p.select({
65
+ message: "Choose a template",
66
+ options: TEMPLATES.map((t) => ({
67
+ value: t.id,
68
+ label: t.label,
69
+ hint: pc.dim(t.hint)
70
+ }))
71
+ })
72
+ },
73
+ {
74
+ onCancel: () => {
75
+ p.cancel("Cancelled.");
76
+ process.exit(0);
77
+ }
78
+ }
79
+ );
80
+ const s = p.spinner();
81
+ if (needsInit && projectName) {
82
+ s.start("Creating project structure");
83
+ await scaffoldProject({ projectName, cwd });
84
+ s.stop("Project structure created");
85
+ const pm = await detectPackageManager(cwd);
86
+ const pmName = pm?.name ?? "npm";
87
+ s.start(`Installing dependencies ${pc.dim(`(${pmName} install)`)}`);
88
+ try {
89
+ await installDependencies({ cwd: join(cwd, "kalp"), silent: true });
90
+ s.stop("Dependencies installed");
91
+ } catch {
92
+ s.stop(pc.yellow("Install skipped \u2014 run manually inside kalp/"));
93
+ }
94
+ }
95
+ s.start(`Scaffolding agent ${pc.cyan(agentAnswers.name)}`);
96
+ await scaffoldAgent({
97
+ agentName: agentAnswers.name,
98
+ templateId: agentAnswers.template,
99
+ cwd
100
+ });
101
+ s.stop("Agent created");
102
+ p.note(
103
+ [
104
+ `${pc.dim("\u2022")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/index.ts`)}`,
105
+ `${pc.dim("\u2022")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/steps/`)}`,
106
+ `${pc.dim("\u2022")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/tools/`)}`
107
+ ].join("\n"),
108
+ "Created"
109
+ );
110
+ p.outro(
111
+ `${LOGO} ${pc.green(`Agent ${pc.bold(agentAnswers.name)} is ready.`)}`
112
+ );
113
+ }
114
+ });
115
+ export {
116
+ create_default as default
117
+ };
118
+ //# sourceMappingURL=create-VKJ6C6DZ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/create.ts"],"sourcesContent":["import { join } from \"node:path\";\nimport { access } from \"node:fs/promises\";\nimport { defineCommand } from \"citty\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { installDependencies, detectPackageManager } from \"nypm\";\nimport { scaffoldProject, scaffoldAgent } from \"../scaffold.js\";\nimport { TEMPLATES, type TemplateId } from \"../templates/index.js\";\n\nconst LOGO = \"🦋\";\n\nexport default defineCommand({\n meta: { name: \"create\", description: \"Add a new agent to the project\" },\n async run() {\n const cwd = process.cwd();\n\n p.intro(`${LOGO} ${pc.bold(\"kalp create\")}`);\n\n // ── Check if project is initialized ─────────────────────────────────\n let needsInit = false;\n try {\n await access(join(cwd, \"kalp.config.ts\"));\n } catch {\n needsInit = true;\n }\n\n // ── Init phase (inline — one unified timeline) ───────────────────────\n let projectName: string | undefined;\n if (needsInit) {\n p.log.warn(\n `No ${pc.cyan(\"kalp.config.ts\")} found — initializing project first.`,\n );\n\n const initAnswers = await p.group(\n {\n name: () =>\n p.text({\n message: \"Project name?\",\n placeholder: \"my-project\",\n validate: (v) => {\n if (!v.trim()) return \"Project name is required.\";\n if (!/^[a-z0-9-]+$/.test(v))\n return \"Use lowercase letters, numbers, and dashes only.\";\n },\n }),\n },\n {\n onCancel: () => {\n p.cancel(\"Cancelled.\");\n process.exit(0);\n },\n },\n );\n\n projectName = initAnswers.name;\n }\n\n // ── Agent prompts ────────────────────────────────────────────────────\n const agentAnswers = await p.group(\n {\n name: () =>\n p.text({\n message: \"Agent name?\",\n placeholder: \"my-agent\",\n validate: (v) => {\n if (!v.trim()) return \"Agent name is required.\";\n if (!/^[a-z0-9-]+$/.test(v))\n return \"Use lowercase letters, numbers, and dashes only.\";\n },\n }),\n template: () =>\n p.select<TemplateId>({\n message: \"Choose a template\",\n options: TEMPLATES.map((t) => ({\n value: t.id,\n label: t.label,\n hint: pc.dim(t.hint),\n })),\n }),\n },\n {\n onCancel: () => {\n p.cancel(\"Cancelled.\");\n process.exit(0);\n },\n },\n );\n\n const s = p.spinner();\n\n // ── Scaffold project if needed ───────────────────────────────────────\n if (needsInit && projectName) {\n s.start(\"Creating project structure\");\n await scaffoldProject({ projectName, cwd });\n s.stop(\"Project structure created\");\n\n const pm = await detectPackageManager(cwd);\n const pmName = pm?.name ?? \"npm\";\n s.start(`Installing dependencies ${pc.dim(`(${pmName} install)`)}`);\n try {\n await installDependencies({ cwd: join(cwd, \"kalp\"), silent: true });\n s.stop(\"Dependencies installed\");\n } catch {\n s.stop(pc.yellow(\"Install skipped — run manually inside kalp/\"));\n }\n }\n\n // ── Scaffold agent ───────────────────────────────────────────────────\n s.start(`Scaffolding agent ${pc.cyan(agentAnswers.name)}`);\n await scaffoldAgent({\n agentName: agentAnswers.name,\n templateId: agentAnswers.template as TemplateId,\n cwd,\n });\n s.stop(\"Agent created\");\n\n p.note(\n [\n `${pc.dim(\"•\")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/index.ts`)}`,\n `${pc.dim(\"•\")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/steps/`)}`,\n `${pc.dim(\"•\")} ${pc.cyan(`kalp/agents/${agentAnswers.name}/tools/`)}`,\n ].join(\"\\n\"),\n \"Created\",\n );\n\n p.outro(\n `${LOGO} ${pc.green(`Agent ${pc.bold(agentAnswers.name)} is ready.`)}`,\n );\n },\n});\n"],"mappings":"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","names":[]}
package/dist/index.js ADDED
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/index.ts
4
+ import { defineCommand, runMain } from "citty";
5
+ var main = defineCommand({
6
+ meta: {
7
+ name: "kalp",
8
+ version: "0.0.1",
9
+ description: "\u{1F98B} Zero-config agent infrastructure"
10
+ },
11
+ subCommands: {
12
+ init: () => import("./init-5UAVM2WR.js").then((r) => r.default),
13
+ create: () => import("./create-VKJ6C6DZ.js").then((r) => r.default),
14
+ build: () => import("./build-ZMN2247N.js").then((r) => r.default)
15
+ }
16
+ });
17
+ runMain(main);
18
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { defineCommand, runMain } from \"citty\";\n\nconst main = defineCommand({\n meta: {\n name: \"kalp\",\n version: \"0.0.1\",\n description: \"🦋 Zero-config agent infrastructure\",\n },\n subCommands: {\n init: () => import(\"./commands/init.js\").then((r) => r.default),\n create: () => import(\"./commands/create.js\").then((r) => r.default),\n build: () => import(\"./commands/build.js\").then((r) => r.default),\n },\n});\n\nrunMain(main);\n"],"mappings":";;;AAAA,SAAS,eAAe,eAAe;AAEvC,IAAM,OAAO,cAAc;AAAA,EACzB,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,SAAS;AAAA,IACT,aAAa;AAAA,EACf;AAAA,EACA,aAAa;AAAA,IACX,MAAM,MAAM,OAAO,oBAAoB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,IAC9D,QAAQ,MAAM,OAAO,sBAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,IAClE,OAAO,MAAM,OAAO,qBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;AAAA,EAClE;AACF,CAAC;AAED,QAAQ,IAAI;","names":[]}
@@ -0,0 +1,74 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ scaffoldProject
4
+ } from "./chunk-VMU456Z7.js";
5
+
6
+ // src/commands/init.ts
7
+ import { join } from "path";
8
+ import { access } from "fs/promises";
9
+ import { defineCommand } from "citty";
10
+ import * as p from "@clack/prompts";
11
+ import pc from "picocolors";
12
+ import { addDependency } from "nypm";
13
+ var LOGO = "\u{1F98B}";
14
+ var init_default = defineCommand({
15
+ meta: { name: "init", description: "Scaffold a new Kalp project" },
16
+ async run() {
17
+ const cwd = process.cwd();
18
+ p.intro(`${LOGO} ${pc.bold("kalp init")}`);
19
+ try {
20
+ await access(join(cwd, "kalp.config.ts"));
21
+ p.log.error(
22
+ `${pc.cyan("kalp.config.ts")} already exists. Run ${pc.cyan("kalp create")} to add an agent.`
23
+ );
24
+ process.exit(1);
25
+ } catch {
26
+ }
27
+ const answers = await p.group(
28
+ {
29
+ name: () => p.text({
30
+ message: "What is the name of your project?",
31
+ placeholder: "my-project",
32
+ validate: (v) => {
33
+ if (!v.trim()) return "Project name is required.";
34
+ if (!/^[a-z0-9-]+$/.test(v))
35
+ return "Use lowercase letters, numbers, and dashes only.";
36
+ }
37
+ })
38
+ },
39
+ {
40
+ onCancel: () => {
41
+ p.cancel("Setup cancelled.");
42
+ process.exit(0);
43
+ }
44
+ }
45
+ );
46
+ const s = p.spinner();
47
+ s.start("Creating project structure");
48
+ await scaffoldProject({ projectName: answers.name, cwd });
49
+ s.stop("Project structure created");
50
+ s.start(`Adding ${pc.cyan("@kalphq/sdk")} to your project`);
51
+ try {
52
+ await addDependency("@kalphq/sdk", { cwd, dev: true, silent: true });
53
+ s.stop(`${pc.cyan("@kalphq/sdk")} installed`);
54
+ } catch {
55
+ s.stop(pc.yellow(`Skipped \u2014 run manually: npm install -D @kalphq/sdk`));
56
+ }
57
+ p.note(
58
+ [
59
+ `${pc.dim("\u2022")} ${pc.cyan("kalp.config.ts")} ${pc.dim("\u2014 project config")}`,
60
+ `${pc.dim("\u2022")} ${pc.cyan("kalp/")} ${pc.dim("\u2014 agents sub-package")}`,
61
+ ``,
62
+ `${pc.dim("Next:")}`,
63
+ ` 1. ${pc.cyan("cd kalp && npm install")}`,
64
+ ` 2. ${pc.cyan("kalp create")} ${pc.dim("\u2014 add your first agent")}`
65
+ ].join("\n"),
66
+ "You're ready \u{1F98B}"
67
+ );
68
+ p.outro(pc.green("Kalp initialized successfully."));
69
+ }
70
+ });
71
+ export {
72
+ init_default as default
73
+ };
74
+ //# sourceMappingURL=init-5UAVM2WR.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/init.ts"],"sourcesContent":["import { join } from \"node:path\";\nimport { access } from \"node:fs/promises\";\nimport { defineCommand } from \"citty\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { addDependency } from \"nypm\";\nimport { scaffoldProject } from \"../scaffold.js\";\n\nconst LOGO = \"🦋\";\n\nexport default defineCommand({\n meta: { name: \"init\", description: \"Scaffold a new Kalp project\" },\n async run() {\n const cwd = process.cwd();\n\n p.intro(`${LOGO} ${pc.bold(\"kalp init\")}`);\n\n // ── Guard: already initialized ───────────────────────────────────────\n try {\n await access(join(cwd, \"kalp.config.ts\"));\n p.log.error(\n `${pc.cyan(\"kalp.config.ts\")} already exists. Run ${pc.cyan(\"kalp create\")} to add an agent.`,\n );\n process.exit(1);\n } catch {\n // expected: file doesn't exist yet\n }\n\n const answers = await p.group(\n {\n name: () =>\n p.text({\n message: \"What is the name of your project?\",\n placeholder: \"my-project\",\n validate: (v) => {\n if (!v.trim()) return \"Project name is required.\";\n if (!/^[a-z0-9-]+$/.test(v))\n return \"Use lowercase letters, numbers, and dashes only.\";\n },\n }),\n },\n {\n onCancel: () => {\n p.cancel(\"Setup cancelled.\");\n process.exit(0);\n },\n },\n );\n\n const s = p.spinner();\n\n s.start(\"Creating project structure\");\n await scaffoldProject({ projectName: answers.name, cwd });\n s.stop(\"Project structure created\");\n\n s.start(`Adding ${pc.cyan(\"@kalphq/sdk\")} to your project`);\n try {\n await addDependency(\"@kalphq/sdk\", { cwd, dev: true, silent: true });\n s.stop(`${pc.cyan(\"@kalphq/sdk\")} installed`);\n } catch {\n s.stop(pc.yellow(`Skipped — run manually: npm install -D @kalphq/sdk`));\n }\n\n p.note(\n [\n `${pc.dim(\"•\")} ${pc.cyan(\"kalp.config.ts\")} ${pc.dim(\"— project config\")}`,\n `${pc.dim(\"•\")} ${pc.cyan(\"kalp/\")} ${pc.dim(\"— agents sub-package\")}`,\n ``,\n `${pc.dim(\"Next:\")}`,\n ` 1. ${pc.cyan(\"cd kalp && npm install\")}`,\n ` 2. ${pc.cyan(\"kalp create\")} ${pc.dim(\"— add your first agent\")}`,\n ].join(\"\\n\"),\n \"You're ready 🦋\",\n );\n\n p.outro(pc.green(\"Kalp initialized successfully.\"));\n },\n});\n"],"mappings":";;;;;;AAAA,SAAS,YAAY;AACrB,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAC9B,YAAY,OAAO;AACnB,OAAO,QAAQ;AACf,SAAS,qBAAqB;AAG9B,IAAM,OAAO;AAEb,IAAO,eAAQ,cAAc;AAAA,EAC3B,MAAM,EAAE,MAAM,QAAQ,aAAa,8BAA8B;AAAA,EACjE,MAAM,MAAM;AACV,UAAM,MAAM,QAAQ,IAAI;AAExB,IAAE,QAAM,GAAG,IAAI,IAAI,GAAG,KAAK,WAAW,CAAC,EAAE;AAGzC,QAAI;AACF,YAAM,OAAO,KAAK,KAAK,gBAAgB,CAAC;AACxC,MAAE,MAAI;AAAA,QACJ,GAAG,GAAG,KAAK,gBAAgB,CAAC,wBAAwB,GAAG,KAAK,aAAa,CAAC;AAAA,MAC5E;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB,QAAQ;AAAA,IAER;AAEA,UAAM,UAAU,MAAQ;AAAA,MACtB;AAAA,QACE,MAAM,MACF,OAAK;AAAA,UACL,SAAS;AAAA,UACT,aAAa;AAAA,UACb,UAAU,CAAC,MAAM;AACf,gBAAI,CAAC,EAAE,KAAK,EAAG,QAAO;AACtB,gBAAI,CAAC,eAAe,KAAK,CAAC;AACxB,qBAAO;AAAA,UACX;AAAA,QACF,CAAC;AAAA,MACL;AAAA,MACA;AAAA,QACE,UAAU,MAAM;AACd,UAAE,SAAO,kBAAkB;AAC3B,kBAAQ,KAAK,CAAC;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAEA,UAAM,IAAM,UAAQ;AAEpB,MAAE,MAAM,4BAA4B;AACpC,UAAM,gBAAgB,EAAE,aAAa,QAAQ,MAAM,IAAI,CAAC;AACxD,MAAE,KAAK,2BAA2B;AAElC,MAAE,MAAM,UAAU,GAAG,KAAK,aAAa,CAAC,kBAAkB;AAC1D,QAAI;AACF,YAAM,cAAc,eAAe,EAAE,KAAK,KAAK,MAAM,QAAQ,KAAK,CAAC;AACnE,QAAE,KAAK,GAAG,GAAG,KAAK,aAAa,CAAC,YAAY;AAAA,IAC9C,QAAQ;AACN,QAAE,KAAK,GAAG,OAAO,yDAAoD,CAAC;AAAA,IACxE;AAEA,IAAE;AAAA,MACA;AAAA,QACE,GAAG,GAAG,IAAI,QAAG,CAAC,IAAI,GAAG,KAAK,gBAAgB,CAAC,IAAI,GAAG,IAAI,uBAAkB,CAAC;AAAA,QACzE,GAAG,GAAG,IAAI,QAAG,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC,IAAI,GAAG,IAAI,2BAAsB,CAAC;AAAA,QACpE;AAAA,QACA,GAAG,GAAG,IAAI,OAAO,CAAC;AAAA,QAClB,QAAQ,GAAG,KAAK,wBAAwB,CAAC;AAAA,QACzC,QAAQ,GAAG,KAAK,aAAa,CAAC,IAAI,GAAG,IAAI,6BAAwB,CAAC;AAAA,MACpE,EAAE,KAAK,IAAI;AAAA,MACX;AAAA,IACF;AAEA,IAAE,QAAM,GAAG,MAAM,gCAAgC,CAAC;AAAA,EACpD;AACF,CAAC;","names":[]}
File without changes
package/package.json ADDED
@@ -0,0 +1,39 @@
1
+ {
2
+ "name": "@kalphq/cli",
3
+ "version": "0.0.0-dev-20260416055233",
4
+ "description": "Zero-config CLI for deploying Kalp agents",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "author": "Kalp HQ",
8
+ "bin": {
9
+ "kalp": "./dist/index.js"
10
+ },
11
+ "main": "./dist/index.js",
12
+ "files": [
13
+ "dist",
14
+ "templates"
15
+ ],
16
+ "publishConfig": {
17
+ "access": "public"
18
+ },
19
+ "dependencies": {
20
+ "@clack/prompts": "^0.9.1",
21
+ "citty": "^0.1.6",
22
+ "esbuild": "^0.25.0",
23
+ "giget": "^1.2.3",
24
+ "nypm": "^0.3.12",
25
+ "picocolors": "^1.1.1",
26
+ "zod": "^3.25.76",
27
+ "@kalphq/sdk": "0.0.0-dev-20260416055233"
28
+ },
29
+ "devDependencies": {
30
+ "@types/node": "^22.15.3",
31
+ "tsup": "^8.3.5",
32
+ "typescript": "^5.0.0"
33
+ },
34
+ "scripts": {
35
+ "build": "tsup",
36
+ "dev": "tsup --watch",
37
+ "lint": "tsc --noEmit"
38
+ }
39
+ }
@@ -0,0 +1,28 @@
1
+ import { asAgentId, defineAgent } from "@kalphq/sdk";
2
+ import { scoreLead } from "./steps/score-lead.js";
3
+ import { enrichCompany } from "./tools/enrich-company.js";
4
+
5
+ export default defineAgent({
6
+ id: asAgentId("__AGENT_NAME__"),
7
+ name: "__AGENT_NAME__",
8
+ description: "Automates B2B outreach with lead scoring and CRM enrichment.",
9
+ steps: [scoreLead],
10
+ tools: [enrichCompany],
11
+
12
+ systemPrompt:
13
+ "You are a B2B sales assistant. Score leads, enrich company data, and draft personalized outreach messages.",
14
+
15
+ async onMessage(message, ctx) {
16
+ const lead = await ctx.runStep(scoreLead, { company: message.text });
17
+
18
+ if (lead.score < 50) {
19
+ return { text: "Lead score too low — skipping outreach." };
20
+ }
21
+
22
+ const enriched = await ctx.callTool(enrichCompany, { domain: lead.domain });
23
+
24
+ return {
25
+ text: `${enriched.companyName} (${lead.score}/100) — Ready for outreach.`,
26
+ };
27
+ },
28
+ });
File without changes
@@ -0,0 +1,24 @@
1
+ import { createStep } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const scoreLead = createStep({
5
+ id: "score_lead",
6
+ description: "Scores a B2B lead based on company signals.",
7
+ input: z.object({ company: z.string() }),
8
+ output: z.object({
9
+ score: z.number().min(0).max(100),
10
+ domain: z.string(),
11
+ reason: z.string(),
12
+ }),
13
+ async run({ company }, ctx) {
14
+ const result = await ctx.ai.generateObject({
15
+ prompt: `Score this B2B lead for "${company}". Provide a score 0-100, the company domain, and a brief reason.`,
16
+ schema: z.object({
17
+ score: z.number().min(0).max(100),
18
+ domain: z.string(),
19
+ reason: z.string(),
20
+ }),
21
+ });
22
+ return result;
23
+ },
24
+ });
@@ -0,0 +1,17 @@
1
+ import { createTool } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const enrichCompany = createTool({
5
+ id: "enrich_company",
6
+ description: "Fetches enriched company data from the CRM.",
7
+ input: z.object({ domain: z.string() }),
8
+ async execute({ domain }, ctx) {
9
+ ctx.logger.info("Enriching company", { domain });
10
+ // Replace with actual CRM API call
11
+ return {
12
+ companyName: domain.split(".")[0] ?? domain,
13
+ employees: 0,
14
+ industry: "Unknown",
15
+ };
16
+ },
17
+ });
File without changes
@@ -0,0 +1,28 @@
1
+ import { asAgentId, defineAgent } from "@kalphq/sdk";
2
+ import { classifyTicket } from "./steps/classify-ticket.js";
3
+ import { searchKnowledgeBase } from "./tools/search-kb.js";
4
+
5
+ export default defineAgent({
6
+ id: asAgentId("__AGENT_NAME__"),
7
+ name: "__AGENT_NAME__",
8
+ description: "Handles incoming support tickets with AI-powered routing.",
9
+ steps: [classifyTicket],
10
+ tools: [searchKnowledgeBase],
11
+
12
+ systemPrompt:
13
+ "You are a friendly support agent. Classify tickets, search the knowledge base, and resolve issues efficiently.",
14
+
15
+ async onMessage(message, ctx) {
16
+ const ticket = await ctx.runStep(classifyTicket, { text: message.text });
17
+
18
+ if (ticket.category === "billing") {
19
+ return { text: "Routing to billing team..." };
20
+ }
21
+
22
+ const results = await ctx.callTool(searchKnowledgeBase, {
23
+ query: message.text,
24
+ });
25
+
26
+ return { text: results.answer ?? "Let me escalate this to a human agent." };
27
+ },
28
+ });
@@ -0,0 +1,22 @@
1
+ import { createStep } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const classifyTicket = createStep({
5
+ id: "classify_ticket",
6
+ description: "Classifies a support ticket by category and priority.",
7
+ input: z.object({ text: z.string() }),
8
+ output: z.object({
9
+ category: z.enum(["billing", "technical", "general"]),
10
+ priority: z.enum(["low", "medium", "high"]),
11
+ }),
12
+ async run({ text }, ctx) {
13
+ const result = await ctx.ai.generateObject({
14
+ prompt: `Classify this support ticket: "${text}"`,
15
+ schema: z.object({
16
+ category: z.enum(["billing", "technical", "general"]),
17
+ priority: z.enum(["low", "medium", "high"]),
18
+ }),
19
+ });
20
+ return result;
21
+ },
22
+ });
@@ -0,0 +1,13 @@
1
+ import { createTool } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const searchKnowledgeBase = createTool({
5
+ id: "search_kb",
6
+ description: "Searches the product knowledge base for relevant articles.",
7
+ input: z.object({ query: z.string() }),
8
+ async execute({ query }, ctx) {
9
+ ctx.logger.info("Searching KB", { query });
10
+ // Replace with your actual knowledge base search logic
11
+ return { answer: null as string | null, sources: [] as string[] };
12
+ },
13
+ });
@@ -0,0 +1,28 @@
1
+ import { asAgentId, defineAgent } from "@kalphq/sdk";
2
+ import { analyzeSignal } from "./steps/analyze-signal.js";
3
+ import { fetchMarketData } from "./tools/fetch-market-data.js";
4
+
5
+ export default defineAgent({
6
+ id: asAgentId("__AGENT_NAME__"),
7
+ name: "__AGENT_NAME__",
8
+ description: "Monitors market signals and provides financial analysis.",
9
+ steps: [analyzeSignal],
10
+ tools: [fetchMarketData],
11
+
12
+ systemPrompt:
13
+ "You are a financial analysis agent. Interpret market signals, fetch live data, and provide actionable insights.",
14
+
15
+ async onMessage(message, ctx) {
16
+ const market = await ctx.callTool(fetchMarketData, {
17
+ symbol: message.text.trim().toUpperCase(),
18
+ });
19
+
20
+ const analysis = await ctx.runStep(analyzeSignal, {
21
+ symbol: market.symbol,
22
+ price: market.price,
23
+ change: market.change,
24
+ });
25
+
26
+ return { text: analysis.summary };
27
+ },
28
+ });
@@ -0,0 +1,26 @@
1
+ import { createStep } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const analyzeSignal = createStep({
5
+ id: "analyze_signal",
6
+ description: "Analyzes a market signal and produces a summary.",
7
+ input: z.object({
8
+ symbol: z.string(),
9
+ price: z.number(),
10
+ change: z.number(),
11
+ }),
12
+ output: z.object({
13
+ sentiment: z.enum(["bullish", "bearish", "neutral"]),
14
+ summary: z.string(),
15
+ }),
16
+ async run({ symbol, price, change }, ctx) {
17
+ const result = await ctx.ai.generateObject({
18
+ prompt: `Analyze this market signal: ${symbol} at $${price} (${change > 0 ? "+" : ""}${change}%). Give sentiment and a one-line summary.`,
19
+ schema: z.object({
20
+ sentiment: z.enum(["bullish", "bearish", "neutral"]),
21
+ summary: z.string(),
22
+ }),
23
+ });
24
+ return result;
25
+ },
26
+ });
@@ -0,0 +1,13 @@
1
+ import { createTool } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const fetchMarketData = createTool({
5
+ id: "fetch_market_data",
6
+ description: "Fetches real-time market data for a given symbol.",
7
+ input: z.object({ symbol: z.string() }),
8
+ async execute({ symbol }, ctx) {
9
+ ctx.logger.info("Fetching market data", { symbol });
10
+ // Replace with actual market data API call
11
+ return { symbol, price: 0, change: 0, volume: 0 };
12
+ },
13
+ });
@@ -0,0 +1,16 @@
1
+ import { asAgentId, defineAgent } from "@kalphq/sdk";
2
+ import { exampleStep } from "./steps/example-step.js";
3
+ import { exampleTool } from "./tools/example-tool.js";
4
+
5
+ export default defineAgent({
6
+ id: asAgentId("__AGENT_NAME__"),
7
+ name: "__AGENT_NAME__",
8
+ steps: [exampleStep],
9
+ tools: [exampleTool],
10
+
11
+ async onMessage(message, ctx) {
12
+ const stepped = await ctx.runStep(exampleStep, { message: message.text });
13
+ const tooled = await ctx.callTool(exampleTool, { query: message.text });
14
+ return { text: `${stepped.result} | ${tooled.output}` };
15
+ },
16
+ });
File without changes
@@ -0,0 +1,13 @@
1
+ import { createStep } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const exampleStep = createStep({
5
+ id: "example_step",
6
+ description: "A stub step — replace with your own logic.",
7
+ input: z.object({ message: z.string() }),
8
+ output: z.object({ result: z.string() }),
9
+ async run({ message }, ctx) {
10
+ ctx.logger.info("Running example step", { message });
11
+ return { result: `Processed: ${message}` };
12
+ },
13
+ });
@@ -0,0 +1,13 @@
1
+ import { createTool } from "@kalphq/sdk";
2
+ import { z } from "zod";
3
+
4
+ export const exampleTool = createTool({
5
+ id: "example_tool",
6
+ description: "A stub tool — replace with your own external call.",
7
+ input: z.object({ query: z.string() }),
8
+ async execute({ query }, ctx) {
9
+ ctx.logger.info("Calling example tool", { query });
10
+ // Replace with your actual external API call
11
+ return { output: `Result for: ${query}` };
12
+ },
13
+ });
File without changes
@@ -0,0 +1 @@
1
+ { "deployments": [] }
@@ -0,0 +1,13 @@
1
+ {
2
+ "name": "__PROJECT_NAME__",
3
+ "version": "0.0.1",
4
+ "private": true,
5
+ "type": "module",
6
+ "scripts": {
7
+ "build": "kalp build"
8
+ },
9
+ "dependencies": {
10
+ "@kalphq/sdk": "latest",
11
+ "zod": "^3.25.76"
12
+ }
13
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "ESNext",
5
+ "moduleResolution": "bundler",
6
+ "strict": true,
7
+ "esModuleInterop": true,
8
+ "skipLibCheck": true,
9
+ "outDir": "dist",
10
+ "rootDir": "."
11
+ },
12
+ "include": ["agents/**/*.ts", "../kalp.config.ts"],
13
+ "exclude": ["node_modules", "dist", "meta"]
14
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "name": "__PROJECT_NAME__",
3
+ "version": "0.0.1",
4
+ "private": true,
5
+ "devDependencies": {
6
+ "@kalphq/cli": "latest",
7
+ "@kalphq/sdk": "latest"
8
+ }
9
+ }