@elevasis/sdk 0.5.21 → 0.5.23

package/dist/templates.js

@@ -1,7 +1,7 @@
 // package.json
 
 // src/cli/commands/templates/core/workspace.ts
-var TEMPLATE_VERSION = 31;
+var TEMPLATE_VERSION = 32;
 function configTemplate() {
   return `import type { ElevasConfig } from '@elevasis/sdk'
 
@@ -1744,6 +1744,77 @@ When all plan steps are marked COMPLETE, **suggest** completing the task -- neve
 - Completed tasks move OUT of \`docs/in-progress/\` to \`docs/<relevant-dir>/\`
 `;
 }
+function claudeLoggingRuleTemplate() {
+  return `---
+description: Logging conventions for workflow and agent handlers
+paths:
+  - src/**
+---
+
+# Logging
+
+## Always Use \`context.logger\` in Handlers
+
+**Never use \`console.log\`, \`console.warn\`, or \`console.error\` in step/agent handlers.**
+The platform does not capture \`console.*\` output \u2014 it will not appear in execution logs.
+
+\`\`\`typescript
+// \u274C WRONG \u2014 invisible in Command Center
+handler: async (rawInput) => {
+  console.log('Processing...')
+}
+
+// \u2705 CORRECT \u2014 visible in Command Center
+handler: async (rawInput, context) => {
+  context.logger.info('Processing...')
+}
+\`\`\`
+
+## Logger Methods
+
+\`\`\`typescript
+context.logger.debug('Verbose detail \u2014 shown in debug mode only')
+context.logger.info('Normal progress messages')
+context.logger.warn('Non-fatal issue \u2014 skipped, retried, partial result')
+context.logger.error('Fatal error or unexpected failure')
+\`\`\`
+
+## Extensive Logging Standard
+
+Every handler should log:
+
+1. **Entry** \u2014 step name + key input params (category, count, domain, etc.)
+2. **Progress** \u2014 inside loops: per-item status (processed, skipped, failed)
+3. **Decisions** \u2014 idempotency skips, early exits, conditional branches
+4. **Summary** \u2014 counts at the end (X processed, Y skipped, Z errors)
+
+\`\`\`typescript
+handler: async (rawInput, context) => {
+  const data = rawInput as SomeType
+  context.logger.info(\`[step-name] Starting \u2014 \${data.items.length} items\`)
+
+  let processed = 0, skipped = 0
+  for (const item of data.items) {
+    if (item.alreadyDone) {
+      skipped++
+      context.logger.info(\`[step-name] Skipping \${item.name} \u2014 already complete\`)
+      continue
+    }
+    // ...
+    processed++
+    context.logger.info(\`[step-name] Processed \${item.name}\`)
+  }
+
+  context.logger.info(\`[step-name] Done \u2014 \${processed} processed, \${skipped} skipped\`)
+}
+\`\`\`
+
+## Warnings vs Errors
+
+- \`warn\`: skipped item, not found in DB, LLM timeout on one domain (processing continues)
+- \`error\`: step-level failures that propagate as thrown errors (log before throwing if possible)
+`;
+}
 function claudePostEditValidateHookTemplate() {
   return `#!/usr/bin/env node
 // post-edit-validate.mjs
@@ -2105,7 +2176,8 @@ function getManagedTemplates(ctx = {}) {
     ".claude/rules/docs-authoring.md": claudeDocsAuthoringRuleTemplate,
     ".claude/rules/memory-conventions.md": claudeMemoryConventionsRuleTemplate,
     ".claude/rules/project-map.md": claudeProjectMapRuleTemplate,
-    ".claude/rules/task-tracking.md": claudeTaskTrackingRuleTemplate
+    ".claude/rules/task-tracking.md": claudeTaskTrackingRuleTemplate,
+    ".claude/rules/logging.md": claudeLoggingRuleTemplate
   };
 }
 

package/dist/types/worker/adapters/instantly.d.ts

@@ -9,6 +9,6 @@ import type { InstantlyToolMap } from '../../types/index.js';
  * Create a typed Instantly adapter bound to a specific credential.
  *
  * @param credential - Credential name as configured in the command center
- * @returns Object with 5 typed methods for Instantly email outreach operations
+ * @returns Object with 16 typed methods for Instantly email outreach operations
  */
 export declare function createInstantlyAdapter(credential: string): import("./create-adapter.js").TypedAdapter<InstantlyToolMap>;

package/dist/types/worker/adapters/llm.d.ts

@@ -6,7 +6,22 @@
  *
  * Types are shared with the server-side LLM engine via @repo/core/execution.
  */
-import type { LLMGenerateRequest, LLMGenerateResponse } from '../../types/index.js';
+import type { LLMGenerateRequest, LLMGenerateResponse, LLMModel } from '../../types/index.js';
+type LLMProvider = 'openai' | 'anthropic' | 'openrouter' | 'google';
+/**
+ * SDK LLM generate params.
+ * Extends LLMGenerateRequest with optional typed provider/model for worker→platform dispatch.
+ * When provided, these override the resource-level model config server-side.
+ * When omitted, the resource's default ModelConfig is used.
+ */
+export interface SDKLLMGenerateParams extends Omit<LLMGenerateRequest, 'signal' | 'responseSchema'> {
+    /** LLM provider — typed to prevent invalid provider strings */
+    provider?: LLMProvider;
+    /** Model identifier — must be a supported LLMModel when provided */
+    model?: LLMModel;
+    /** JSON Schema for structured output (optional — omit for unstructured text) */
+    responseSchema?: unknown;
+}
 /**
  * Typed LLM adapter for structured output generation.
  *
@@ -19,6 +34,8 @@ import type { LLMGenerateRequest, LLMGenerateResponse } from '../../types/index.
  * import { llm } from '@elevasis/sdk/worker'
  *
  * const response = await llm.generate({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-5',
  *   messages: [{ role: 'user', content: 'Summarize this document...' }],
  *   responseSchema: { type: 'object', properties: { summary: { type: 'string' } } },
  * })
@@ -26,5 +43,6 @@ import type { LLMGenerateRequest, LLMGenerateResponse } from '../../types/index.
  * ```
  */
 export declare const llm: {
-    generate: <T = unknown>(params: Omit<LLMGenerateRequest, "signal">) => Promise<LLMGenerateResponse<T>>;
+    generate: <T = unknown>(params: SDKLLMGenerateParams) => Promise<LLMGenerateResponse<T>>;
 };
+export {};

package/dist/worker/index.js

@@ -4788,7 +4788,17 @@ function createAdapter(tool, methods, credential) {
   for (const method of methods) {
     adapter[method] = (params) => platform.call({ tool, method, params: params ?? {}, credential });
   }
-  return adapter;
+  const registeredMethods = new Set(methods);
+  return new Proxy(adapter, {
+    get(target, prop, receiver) {
+      if (typeof prop === "string" && !registeredMethods.has(prop) && !(prop in target)) {
+        throw new Error(
+          `${tool}.${prop} is not a registered method. Available: ${[...registeredMethods].join(", ")}. Add '${prop}' to createAdapter('${tool}', [...]) in the SDK adapter.`
+        );
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
 }
 
 // src/worker/adapters/attio.ts
@@ -4811,7 +4821,7 @@ function createAttioAdapter(credential) {
 }
 
 // src/worker/adapters/apify.ts
-var METHODS2 = ["runActor", "getDatasetItems"];
+var METHODS2 = ["runActor", "getDatasetItems", "startActor"];
 function createApifyAdapter(credential) {
   return createAdapter("apify", METHODS2, credential);
 }
@@ -4859,7 +4869,18 @@ var METHODS6 = [
   "removeFromSubsequence",
   "getEmails",
   "updateInterestStatus",
-  "addToCampaign"
+  "addToCampaign",
+  "listCampaigns",
+  "getCampaign",
+  "updateCampaign",
+  "pauseCampaign",
+  "activateCampaign",
+  "getCampaignAnalytics",
+  "getStepAnalytics",
+  "bulkAddLeads",
+  "getAccountHealth",
+  "createInboxTest",
+  "createCampaign"
 ];
 function createInstantlyAdapter(credential) {
   return createAdapter("instantly", METHODS6, credential);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -32,11 +32,6 @@
     "dist/types/templates.d.ts",
     "reference/"
   ],
-  "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs",
-    "check-types": "tsc --noEmit",
-    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
-  },
   "dependencies": {
     "esbuild": "^0.25.0",
     "jiti": "^2.0.0"
@@ -45,8 +40,6 @@
     "zod": "^4.1.0"
   },
   "devDependencies": {
-    "@repo/core": "workspace:*",
-    "@repo/typescript-config": "workspace:*",
     "@types/node": "^22.0.0",
     "chalk": "^5.3.0",
     "commander": "^11.0.0",
@@ -57,6 +50,13 @@
     "rollup-plugin-dts": "^6.3.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
-    "zod": "^4.1.0"
+    "zod": "^4.1.0",
+    "@repo/core": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs",
+    "check-types": "tsc --noEmit",
+    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
   }
-}
+}