@elevasis/sdk 0.4.8 → 0.4.10

package/dist/worker/index.js

@@ -4744,6 +4744,250 @@ function createPostMessageAdapterFactory() {
   return (config) => new PostMessageLLMAdapter(config.provider, config.model);
 }
 
+// src/worker/adapters/create-adapter.ts
+function createAdapter(tool, methods, credential) {
+  const adapter = {};
+  for (const method of methods) {
+    adapter[method] = (params) => platform.call({ tool, method, params: params ?? {}, credential });
+  }
+  return adapter;
+}
+
+// src/worker/adapters/attio.ts
+var METHODS = [
+  "createRecord",
+  "updateRecord",
+  "listRecords",
+  "getRecord",
+  "deleteRecord",
+  "listObjects",
+  "listAttributes",
+  "createAttribute",
+  "updateAttribute",
+  "createNote",
+  "listNotes",
+  "deleteNote"
+];
+function createAttioAdapter(credential) {
+  return createAdapter("attio", METHODS, credential);
+}
+
+// src/worker/adapters/apify.ts
+var METHODS2 = [
+  "runActor"
+];
+function createApifyAdapter(credential) {
+  return createAdapter("apify", METHODS2, credential);
+}
+
+// src/worker/adapters/dropbox.ts
+var METHODS3 = [
+  "uploadFile",
+  "createFolder"
+];
+function createDropboxAdapter(credential) {
+  return createAdapter("dropbox", METHODS3, credential);
+}
+
+// src/worker/adapters/gmail.ts
+var METHODS4 = [
+  "sendEmail"
+];
+function createGmailAdapter(credential) {
+  return createAdapter("gmail", METHODS4, credential);
+}
+
+// src/worker/adapters/google-sheets.ts
+var METHODS5 = [
+  "readSheet",
+  "writeSheet",
+  "appendRows",
+  "clearRange",
+  "getSpreadsheetMetadata",
+  "batchUpdate",
+  "getHeaders",
+  "getLastRow",
+  "getRowByValue",
+  "updateRowByValue",
+  "upsertRow",
+  "filterRows",
+  "deleteRowByValue"
+];
+function createGoogleSheetsAdapter(credential) {
+  return createAdapter("google-sheets", METHODS5, credential);
+}
+
+// src/worker/adapters/instantly.ts
+var METHODS6 = [
+  "sendReply",
+  "removeFromSubsequence",
+  "getEmails",
+  "updateInterestStatus",
+  "addToCampaign"
+];
+function createInstantlyAdapter(credential) {
+  return createAdapter("instantly", METHODS6, credential);
+}
+
+// src/worker/adapters/mailso.ts
+var METHODS7 = [
+  "verifyEmail"
+];
+function createMailsoAdapter(credential) {
+  return createAdapter("mailso", METHODS7, credential);
+}
+
+// src/worker/adapters/notion.ts
+var METHODS8 = [
+  "listAllPages",
+  "readPage",
+  "createPage",
+  "updatePageTitle",
+  "appendBlocks",
+  "updateBlocks",
+  "deletePage",
+  "deleteBlocks"
+];
+function createNotionAdapter(credential) {
+  return createAdapter("notion", METHODS8, credential);
+}
+
+// src/worker/adapters/resend.ts
+var METHODS9 = [
+  "sendEmail",
+  "getEmail"
+];
+function createResendAdapter(credential) {
+  return createAdapter("resend", METHODS9, credential);
+}
+
+// src/worker/adapters/signature-api.ts
+var METHODS10 = [
+  "createEnvelope",
+  "voidEnvelope",
+  "downloadDocument",
+  "getEnvelope"
+];
+function createSignatureApiAdapter(credential) {
+  return createAdapter("signature-api", METHODS10, credential);
+}
+
+// src/worker/adapters/stripe.ts
+var METHODS11 = [
+  "createPaymentLink",
+  "getPaymentLink",
+  "updatePaymentLink",
+  "listPaymentLinks",
+  "createAutoPaymentLink",
+  "createCheckoutSession"
+];
+function createStripeAdapter(credential) {
+  return createAdapter("stripe", METHODS11, credential);
+}
+
+// src/worker/adapters/trello.ts
+var METHODS12 = [
+  "getBoard",
+  "getLists",
+  "getCards",
+  "createCard",
+  "updateCard",
+  "createList",
+  "createChecklist",
+  "addChecklistItem",
+  "updateChecklistItem",
+  "getCardChecklists"
+];
+function createTrelloAdapter(credential) {
+  return createAdapter("trello", METHODS12, credential);
+}
+
+// src/worker/adapters/scheduler.ts
+var scheduler = createAdapter("scheduler", [
+  "createSchedule",
+  "updateAnchor",
+  "deleteSchedule",
+  "findByIdempotencyKey",
+  "deleteScheduleByIdempotencyKey",
+  "listSchedules",
+  "getSchedule",
+  "cancelSchedule",
+  "cancelSchedulesByMetadata"
+]);
+
+// src/worker/adapters/llm.ts
+var llm = {
+  generate: (params) => platform.call({ tool: "llm", method: "generate", params })
+};
+
+// src/worker/adapters/storage.ts
+var storage = createAdapter("storage", [
+  "upload",
+  "download",
+  "createSignedUrl",
+  "delete",
+  "list"
+]);
+
+// src/worker/adapters/notification.ts
+var notifications = createAdapter("notification", ["create"]);
+
+// src/worker/adapters/lead.ts
+var lead = createAdapter("lead", [
+  // List operations
+  "listLists",
+  "createList",
+  "updateList",
+  "deleteList",
+  // Company operations
+  "createCompany",
+  "upsertCompany",
+  "updateCompany",
+  "getCompany",
+  "listCompanies",
+  "deleteCompany",
+  // Contact operations
+  "createContact",
+  "upsertContact",
+  "updateContact",
+  "getContact",
+  "getContactByEmail",
+  "listContacts",
+  "deleteContact",
+  "bulkImportContacts",
+  // Deal operations
+  "upsertDeal",
+  "getDealByEmail",
+  "getDealByEnvelopeId",
+  "updateDealEnvelopeId",
+  "getDealByAttioId",
+  // Deal-sync operations
+  "updateDiscoveryData",
+  "updateProposalData",
+  "markProposalSent",
+  "markProposalReviewed",
+  "updateCloseLostReason",
+  "updateFees",
+  "syncDealStage",
+  "setContactNurture",
+  "cancelSchedulesAndHitlByEmail",
+  "cancelHitlByDealId",
+  "clearDealFields",
+  "deleteDeal"
+]);
+
+// src/worker/adapters/pdf.ts
+var pdf = createAdapter("pdf", ["render", "renderToBuffer"]);
+
+// src/worker/adapters/approval.ts
+var approval = createAdapter("approval", ["create", "deleteByMetadata"]);
+
+// src/worker/adapters/execution.ts
+var execution = createAdapter("execution", ["trigger"]);
+
+// src/worker/adapters/email.ts
+var email = createAdapter("email", ["send"]);
+
 // src/worker/index.ts
 function resolveNext(next, data) {
   if (next === null) return null;
@@ -4755,11 +4999,20 @@ function resolveNext(next, data) {
 }
 async function executeWorkflow(workflow, input, context) {
   const logs = [];
+  const postLog = (level, message) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const entry = { level, message, timestamp };
+    logs.push(entry);
+    parentPort.postMessage({
+      type: "log",
+      entry: { level, message, timestamp, executionId: context.executionId }
+    });
+  };
   const origLog = console.log;
   const origWarn = console.warn;
   const origError = console.error;
   const capture = (level, orig) => (...args) => {
-    logs.push({ level, message: args.map(String).join(" ") });
+    postLog(level, args.map(String).join(" "));
     orig(...args);
   };
   console.log = capture("info", origLog);
@@ -4779,7 +5032,10 @@ async function executeWorkflow(workflow, input, context) {
         organizationId: context.organizationId,
         organizationName: context.organizationName,
         resourceId: workflow.config.resourceId,
-        executionDepth: 0,
+        sessionId: context.sessionId,
+        sessionTurnNumber: context.sessionTurnNumber,
+        parentExecutionId: context.parentExecutionId,
+        executionDepth: context.executionDepth,
         store: /* @__PURE__ */ new Map(),
         logger: {
           debug: (msg) => console.log(`[debug] ${msg}`),
@@ -4801,20 +5057,41 @@ async function executeWorkflow(workflow, input, context) {
     console.error = origError;
   }
 }
-function buildWorkerExecutionContext(executionId, organizationId, organizationName, resourceId) {
+function buildWorkerExecutionContext(params) {
+  const { executionId } = params;
+  const postLog = (level, message) => {
+    parentPort.postMessage({
+      type: "log",
+      entry: { level, message, timestamp: (/* @__PURE__ */ new Date()).toISOString(), executionId }
+    });
+  };
   return {
-    executionId,
-    organizationId,
-    organizationName,
-    resourceId,
-    executionDepth: 0,
+    executionId: params.executionId,
+    organizationId: params.organizationId,
+    organizationName: params.organizationName,
+    resourceId: params.resourceId,
+    sessionId: params.sessionId,
+    sessionTurnNumber: params.sessionTurnNumber,
+    parentExecutionId: params.parentExecutionId,
+    executionDepth: params.executionDepth,
+    signal: params.signal,
     store: /* @__PURE__ */ new Map(),
     logger: {
-      debug: (msg) => console.log(`[debug] ${msg}`),
-      info: (msg) => console.log(`[info] ${msg}`),
-      warn: (msg) => console.warn(`[warn] ${msg}`),
-      error: (msg) => console.error(`[error] ${msg}`),
-      log: () => {
+      debug: (msg) => {
+        console.log(`[debug] ${msg}`);
+        postLog("info", msg);
+      },
+      info: (msg) => {
+        console.log(`[info] ${msg}`);
+        postLog("info", msg);
+      },
+      warn: (msg) => {
+        console.warn(`[warn] ${msg}`);
+        postLog("warn", msg);
+      },
+      error: (msg) => {
+        console.error(`[error] ${msg}`);
+        postLog("error", msg);
       }
     },
     onMessageEvent: async (event) => {
@@ -4829,6 +5106,7 @@ function startWorker(org) {
   const agents = new Map(
     (org.agents ?? []).map((a) => [a.config.resourceId, a])
   );
+  let localAbortController = new AbortController();
   console.log(`[SDK-WORKER] Worker started with ${workflows.size} workflow(s), ${agents.size} agent(s)`);
   parentPort.on("message", async (msg) => {
     if (msg.type === "manifest") {
@@ -4864,24 +5142,46 @@ function startWorker(org) {
       handleCredentialResult(msg);
       return;
     }
+    if (msg.type === "abort") {
+      console.log("[SDK-WORKER] Abort requested by parent");
+      localAbortController.abort();
+      return;
+    }
     if (msg.type === "execute") {
-      const { resourceId, executionId, input, organizationId, organizationName } = msg;
+      const {
+        resourceId,
+        executionId,
+        input,
+        organizationId,
+        organizationName,
+        sessionId,
+        sessionTurnNumber,
+        parentExecutionId,
+        executionDepth
+      } = msg;
       console.log(`[SDK-WORKER] Execute request: resourceId=${resourceId}, executionId=${executionId}`);
+      localAbortController = new AbortController();
       const workflow = workflows.get(resourceId);
       if (workflow) {
+        const startTime = Date.now();
         try {
           console.log(`[SDK-WORKER] Running workflow '${resourceId}' (${Object.keys(workflow.steps).length} steps)`);
-          const startTime = Date.now();
           const { output, logs } = await executeWorkflow(workflow, input, {
             executionId,
             organizationId: organizationId ?? "",
-            organizationName: organizationName ?? ""
+            organizationName: organizationName ?? "",
+            sessionId,
+            sessionTurnNumber,
+            parentExecutionId,
+            executionDepth: executionDepth ?? 0
           });
-          console.log(`[SDK-WORKER] Workflow '${resourceId}' completed (${Date.now() - startTime}ms)`);
-          parentPort.postMessage({ type: "result", status: "completed", output, logs });
+          const durationMs = Date.now() - startTime;
+          console.log(`[SDK-WORKER] Workflow '${resourceId}' completed (${durationMs}ms)`);
+          parentPort.postMessage({ type: "result", status: "completed", output, logs, metrics: { durationMs } });
         } catch (err) {
-          console.error(`[SDK-WORKER] Workflow '${resourceId}' failed: ${String(err)}`);
-          parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [] });
+          const durationMs = Date.now() - startTime;
+          console.error(`[SDK-WORKER] Workflow '${resourceId}' failed (${durationMs}ms): ${String(err)}`);
+          parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [], metrics: { durationMs } });
         }
         return;
       }
@@ -4891,32 +5191,54 @@ function startWorker(org) {
         const origLog = console.log;
         const origWarn = console.warn;
         const origError = console.error;
+        const postLog = (level, message) => {
+          const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+          const entry = { level, message, timestamp };
+          logs.push(entry);
+          parentPort.postMessage({
+            type: "log",
+            entry: { level, message, timestamp, executionId }
+          });
+        };
         const capture = (level, orig) => (...args) => {
-          logs.push({ level, message: args.map(String).join(" ") });
+          postLog(level, args.map(String).join(" "));
           orig(...args);
         };
         console.log = capture("info", origLog);
         console.warn = capture("warn", origWarn);
         console.error = capture("error", origError);
+        const startTime = Date.now();
         try {
           console.log(`[SDK-WORKER] Running agent '${resourceId}' (${agentDef.tools.length} tools)`);
-          const startTime = Date.now();
           const adapterFactory = createPostMessageAdapterFactory();
           const agentInstance = new Agent(agentDef, adapterFactory);
-          const context = buildWorkerExecutionContext(executionId, organizationId ?? "", organizationName ?? "", resourceId);
+          const context = buildWorkerExecutionContext({
+            executionId,
+            organizationId: organizationId ?? "",
+            organizationName: organizationName ?? "",
+            resourceId,
+            sessionId,
+            sessionTurnNumber,
+            parentExecutionId,
+            executionDepth: executionDepth ?? 0,
+            signal: localAbortController.signal
+          });
           const output = await agentInstance.execute(input, context);
-          console.log(`[SDK-WORKER] Agent '${resourceId}' completed (${Date.now() - startTime}ms)`);
-          parentPort.postMessage({ type: "result", status: "completed", output, logs });
+          const durationMs = Date.now() - startTime;
+          console.log(`[SDK-WORKER] Agent '${resourceId}' completed (${durationMs}ms)`);
+          parentPort.postMessage({ type: "result", status: "completed", output, logs, metrics: { durationMs } });
         } catch (err) {
+          const durationMs = Date.now() - startTime;
           const errorMessage = err?.message ?? String(err);
           err?.code ?? "unknown";
           const errorName = err?.name ?? err?.constructor?.name ?? "Error";
-          console.error(`[SDK-WORKER] Agent '${resourceId}' failed: [${errorName}] ${errorMessage}`);
+          console.error(`[SDK-WORKER] Agent '${resourceId}' failed (${durationMs}ms): [${errorName}] ${errorMessage}`);
           parentPort.postMessage({
             type: "result",
             status: "failed",
             error: `${errorName}: ${errorMessage}`,
-            logs
+            logs,
+            metrics: { durationMs }
           });
         } finally {
           console.log = origLog;
@@ -4936,4 +5258,4 @@ function startWorker(org) {
   });
 }
 
-export { PlatformToolError, platform, startWorker };
+export { PlatformToolError, approval, createAdapter, createApifyAdapter, createAttioAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createInstantlyAdapter, createMailsoAdapter, createNotionAdapter, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTrelloAdapter, email, execution, lead, llm, notifications, pdf, platform, scheduler, startWorker, storage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   "type": "module",

package/reference/_navigation.md

@@ -1,104 +1,106 @@
 # SDK Reference Navigation
 
-Auto-generated from reference file frontmatter. 29 files indexed.
+Auto-generated from reference file frontmatter. 31 files indexed.
 
 All paths are relative to `node_modules/@elevasis/sdk/reference/`.
 
 ## General
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Elevasis SDK | `index.mdx` | First session or new to the SDK |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Elevasis SDK | `index.mdx` | Build and deploy workflows, agents, and resources with the Elevasis SDK | First session or new to the SDK |
 
 ## Cli
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| CLI Reference | `cli/index.mdx` | Running CLI operations |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| CLI Reference | `cli/index.mdx` | Full reference for every elevasis CLI command -- scaffold, validate, deploy, execute, and inspect resources | Running CLI operations |
 
 ## Concepts
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Concepts Reference | `concepts/index.mdx` | User asks what is or needs conceptual grounding |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Concepts Reference | `concepts/index.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, common errors, and design decisions | User asks what is or needs conceptual grounding |
 
 ## Deployment
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Execution API | `deployment/api.mdx` | Calling the API directly or debugging API responses |
-| Deploying Resources | `deployment/index.mdx` | Preparing to deploy or debugging deploy failures |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Execution API | `deployment/api.mdx` | REST endpoints for executing resources, querying execution history, and managing deployments via the Elevasis external API | Calling the API directly or debugging API responses |
+| Command View | `deployment/command-view.mdx` | How the Command View graph works -- node types, relationships, what is enforced vs decorative, and what the platform needs to render your resource graph | Deploying resources or building resources that invoke other resources |
+| Deploying Resources | `deployment/index.mdx` | How to deploy your Elevasis SDK resources to the platform using elevasis deploy, including configuration, validation, and environment setup | Preparing to deploy or debugging deploy failures |
 
 ## Developer
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Interaction Guidance | `developer/interaction-guidance.mdx` | Unsure how to adapt for a skill combination |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Interaction Guidance | `developer/interaction-guidance.mdx` | Full dimensional adaptation rules per skill axis -- programming, TypeScript, API integration, automation concepts, domain expertise -- with growth tracking protocol | Unsure how to adapt for a skill combination |
 
 ## Framework
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Agent System | `framework/agent.mdx` | Configuring agent behavior or capabilities |
-| Resource Documentation | `framework/documentation.mdx` | Writing or updating project documentation |
-| Development Framework | `framework/index.mdx` | Understanding the agent framework structure |
-| Memory System | `framework/memory.mdx` | Working with agent memory or session state |
-| Project Structure | `framework/project-structure.mdx` | Understanding scaffolded files or project layout |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Agent System | `framework/agent.mdx` | CLAUDE.md drives all agent behavior -- project instructions, slash commands, memory-based developer profile, and three-tier adaptive guidance | Configuring agent behavior or capabilities |
+| Resource Documentation | `framework/documentation.mdx` | Write and deploy MDX documentation alongside your Elevasis resources | Writing or updating project documentation |
+| Development Framework | `framework/index.mdx` | The SDK scaffolds a complete development environment for Claude Code -- project instructions, slash commands, cross-session memory, and template versioning | Understanding the agent framework structure |
+| Memory System | `framework/memory.mdx` | Cross-session project knowledge stored in .claude/memory/ -- deployment state, environment, decisions, and error patterns that persist between Claude Code sessions | Working with agent memory or session state |
+| Project Structure | `framework/project-structure.mdx` | Each file scaffolded by elevasis init and its purpose in the development workflow | Understanding scaffolded files or project layout |
 
 ## Getting-started
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Getting Started | `getting-started/index.mdx` | Setting up a new project or onboarding |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Getting Started | `getting-started/index.mdx` | Install the Elevasis SDK, scaffold a project, and run your first deployment | Setting up a new project or onboarding |
 
 ## Platform-tools
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Integration Examples | `platform-tools/examples.mdx` | Implementing a platform tool call in a workflow step |
-| Platform Tools | `platform-tools/index.mdx` | Connecting to external services |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Typed Adapters | `platform-tools/adapters.mdx` | Type-safe wrappers over platform.call() for all integrations and platform tools -- Attio, Stripe, Notion, Google Sheets, Trello, and more -- with full autocomplete, compile-time checking, and zero boilerplate | Using typed adapters instead of raw platform.call(), or needs to know what adapter methods are available |
+| Integration Examples | `platform-tools/examples.mdx` | Working code examples for email, CRM, PDF, LLM inference, resource triggering, and storage using typed adapters and platform.call() | Implementing a platform tool call in a workflow step |
+| Platform Tools | `platform-tools/index.mdx` | Access 70+ tools across integration adapters and platform services from your SDK workflows -- typed adapters with full autocomplete for all tools, plus platform.call() as a fallback | Connecting to external services |
 
 ## Resources
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Writing Resources | `resources/index.mdx` | Building or modifying a workflow |
-| Common Patterns | `resources/patterns.mdx` | Building or modifying a workflow |
-| SDK Types | `resources/types.mdx` | Looking up type signatures or SDK exports |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Writing Resources | `resources/index.mdx` | Guide to creating workflows and agents using WorkflowDefinition, AgentDefinition, and OrganizationResources with the Elevasis SDK | Building or modifying a workflow |
+| Common Patterns | `resources/patterns.mdx` | Common resource patterns for Elevasis SDK developers -- sequential steps, conditional branching, platform tools, error handling, and resource status management | Building or modifying a workflow |
+| SDK Types | `resources/types.mdx` | Complete type reference for @elevasis/sdk -- package exports, re-exported platform types, ElevasConfig interface, StepHandler context, and runtime values | Looking up type signatures or SDK exports |
 
 ## Roadmap
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Roadmap | `roadmap/index.mdx` | Asking about future features or planned capabilities |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Roadmap | `roadmap/index.mdx` | Planned SDK features -- error taxonomy, retry semantics, circuit breaker, metrics, alerting, and resource lifecycle extensions | Asking about future features or planned capabilities |
 
 ## Runtime
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Execution Runtime | `runtime/index.mdx` | Debugging execution behavior or understanding the runtime model |
-| Resource Limits & Quotas | `runtime/limits.mdx` | Hitting resource limits or planning for scale |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Execution Runtime | `runtime/index.mdx` | How your code runs on the Elevasis platform -- execution lifecycle, concurrency, timeouts, cancellation, error handling, and observability | Debugging execution behavior or understanding the runtime model |
+| Resource Limits & Quotas | `runtime/limits.mdx` | Memory limits, execution timeouts, scale quotas, networking constraints, and v1 platform limitations for SDK resources | Hitting resource limits or planning for scale |
 
 ## Security
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Credential Security | `security/credentials.mdx` | Setting up integrations or configuring tool access |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Credential Security | `security/credentials.mdx` | Three-layer credential model: platform tools (server-side injection), http tool (arbitrary APIs), getCredential() (explicit opt-in raw access) -- .env scope and security boundaries | Setting up integrations or configuring tool access |
 
 ## Templates
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Template: Data Enrichment | `templates/data-enrichment.mdx` | Applying the data-enrichment workflow template |
-| Template: Email Sender | `templates/email-sender.mdx` | Applying the email-sender workflow template |
-| Template: Lead Scorer | `templates/lead-scorer.mdx` | Applying the lead-scorer workflow template |
-| Template: PDF Generator | `templates/pdf-generator.mdx` | Applying the pdf-generator workflow template |
-| Template: Recurring Job | `templates/recurring-job.mdx` | Applying the recurring-job workflow template |
-| Template: Text Classifier | `templates/text-classifier.mdx` | Applying the text-classifier workflow template |
-| Template: Web Scraper | `templates/web-scraper.mdx` | Applying the web-scraper workflow template |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Template: Data Enrichment | `templates/data-enrichment.mdx` | LLM-powered enrichment of existing database records -- read rows, enrich each with an LLM, write results back to Supabase | Applying the data-enrichment workflow template |
+| Template: Email Sender | `templates/email-sender.mdx` | Transactional email via Resend with template support -- send styled emails to one or multiple recipients | Applying the email-sender workflow template |
+| Template: Lead Scorer | `templates/lead-scorer.mdx` | LLM-based lead scoring with Supabase storage -- receive a lead, score it with an LLM, store the result | Applying the lead-scorer workflow template |
+| Template: PDF Generator | `templates/pdf-generator.mdx` | PDF generation from structured data with platform storage upload -- render a PDF from a template and upload to platform storage | Applying the pdf-generator workflow template |
+| Template: Recurring Job | `templates/recurring-job.mdx` | Scheduler-triggered periodic workflow -- run a task on a schedule (daily, weekly, hourly, or custom cron) | Applying the recurring-job workflow template |
+| Template: Text Classifier | `templates/text-classifier.mdx` | Multi-label text classification with structured output -- classify text into predefined categories using an LLM with JSON output | Applying the text-classifier workflow template |
+| Template: Web Scraper | `templates/web-scraper.mdx` | Apify-based web scraper that stores results in Supabase -- fetch structured data from any website via Apify actors | Applying the web-scraper workflow template |
 
 ## Troubleshooting
 
-| Resource | Location | When to Load |
-| --- | --- | --- |
-| Common Errors | `troubleshooting/common-errors.mdx` | Debugging an unknown error not found in workspace memory |
+| Resource | Location | Description | When to Load |
+| --- | --- | --- | --- |
+| Common Errors | `troubleshooting/common-errors.mdx` | Static SDK-level error catalog -- CLI errors, deployment errors, schema validation, platform tool failures, and runtime errors with diagnostic steps | Debugging an unknown error not found in workspace memory |