@elevasis/sdk 0.5.15 → 0.5.17

package/dist/worker/index.js

@@ -2551,10 +2551,13 @@ function buildReasoningRequest(iterationContext) {
     systemPrompt,
     tools: toolDefinitions,
     constraints: {
-      maxTokens: iterationContext.modelConfig.maxTokens,
+      maxOutputTokens: iterationContext.modelConfig.maxOutputTokens,
       temperature: 1
     },
-    memoryContext: iterationContext.memoryManager.toContext(iterationContext.iteration, iterationContext.executionContext.sessionTurnNumber),
+    memoryContext: iterationContext.memoryManager.toContext(
+      iterationContext.iteration,
+      iterationContext.executionContext.sessionTurnNumber
+    ),
     includeMessageAction: isSessionCapable,
     includeNavigateKnowledge: hasKnowledgeMap,
     includeMemoryOps
@@ -2595,7 +2598,7 @@ var GPT5ConfigSchema = z.object({
   apiKey: z.string(),
   temperature: z.literal(1),
   // Required to be exactly 1
-  maxTokens: z.number().min(4e3).optional(),
+  maxOutputTokens: z.number().min(4e3).optional(),
   topP: z.number().min(0).max(1).optional(),
   modelOptions: GPT5OptionsSchema.optional()
 });
@@ -2604,7 +2607,7 @@ var MockConfigSchema = z.object({
   provider: z.enum(["mock"]),
   apiKey: z.string(),
   temperature: z.number().min(0).max(2).optional(),
-  maxTokens: z.number().min(500).optional(),
+  maxOutputTokens: z.number().min(500).optional(),
   topP: z.number().min(0).max(1).optional(),
   modelOptions: z.object({}).strict().optional()
   // No options supported
@@ -2624,7 +2627,7 @@ var OpenRouterConfigSchema = z.object({
   provider: z.literal("openrouter"),
   apiKey: z.string(),
   temperature: z.number().min(0).max(2).optional(),
-  maxTokens: z.number().min(500).optional(),
+  maxOutputTokens: z.number().min(500).optional(),
   topP: z.number().min(0).max(1).optional(),
   modelOptions: OpenRouterOptionsSchema.optional()
 });
@@ -2638,7 +2641,7 @@ var GoogleConfigSchema = z.object({
   apiKey: z.string(),
   temperature: z.literal(1).optional(),
   // Must be 1 for Gemini 3 (changing degrades performance)
-  maxTokens: z.number().min(500).optional(),
+  maxOutputTokens: z.number().min(500).optional(),
   topP: z.number().min(0).max(1).optional(),
   modelOptions: GoogleOptionsSchema.optional()
 });
@@ -2648,7 +2651,7 @@ var AnthropicConfigSchema = z.object({
   provider: z.literal("anthropic"),
   apiKey: z.string(),
   temperature: z.number().min(0).max(1).optional(),
-  maxTokens: z.number().min(1e3).optional(),
+  maxOutputTokens: z.number().min(1e3).optional(),
   // Anthropic requires max_tokens
   topP: z.number().min(0).max(1).optional(),
   modelOptions: AnthropicOptionsSchema.optional()
@@ -2904,9 +2907,9 @@ var AgentIterationOutputSchema = z.object({
   memoryOps: MemoryOperationsSchema.optional(),
   nextActions: z.array(AgentActionSchema)
 });
-function validateTokenConfiguration(model, maxTokens) {
+function validateTokenConfiguration(model, maxOutputTokens) {
   const modelInfo = getModelInfo(model);
-  const configured = maxTokens || 1e3;
+  const configured = maxOutputTokens || 1e3;
   if (!modelInfo) {
     if (configured < 2e3) {
       throw new InsufficientTokensError(
@@ -2929,15 +2932,20 @@ function validateTokenConfiguration(model, maxTokens) {
   }
 }
 async function callLLMForAgentIteration(adapter, request) {
-  validateTokenConfiguration(request.model, request.constraints.maxTokens);
+  validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
   const messages = [
     { role: "system", content: request.systemPrompt },
     { role: "user", content: request.memoryContext }
   ];
   const response = await adapter.generate({
     messages,
-    responseSchema: buildIterationResponseSchema(request.tools, request.includeMessageAction, request.includeNavigateKnowledge, request.includeMemoryOps),
-    maxTokens: request.constraints.maxTokens,
+    responseSchema: buildIterationResponseSchema(
+      request.tools,
+      request.includeMessageAction,
+      request.includeNavigateKnowledge,
+      request.includeMemoryOps
+    ),
+    maxOutputTokens: request.constraints.maxOutputTokens,
     temperature: request.constraints.temperature,
     signal: request.signal
   });
@@ -2949,16 +2957,13 @@ async function callLLMForAgentIteration(adapter, request) {
       nextActions: validated.nextActions
     };
   } catch (error) {
-    throw new AgentOutputValidationError(
-      "Agent iteration output validation failed",
-      {
-        zodError: error instanceof ZodError ? error.format() : error
-      }
-    );
+    throw new AgentOutputValidationError("Agent iteration output validation failed", {
+      zodError: error instanceof ZodError ? error.format() : error
+    });
   }
 }
 async function callLLMForAgentCompletion(adapter, request) {
-  validateTokenConfiguration(request.model, request.constraints.maxTokens);
+  validateTokenConfiguration(request.model, request.constraints.maxOutputTokens);
   const response = await adapter.generate({
     messages: [
       { role: "system", content: request.systemPrompt },
@@ -2967,7 +2972,7 @@ async function callLLMForAgentCompletion(adapter, request) {
     responseSchema: request.outputSchema,
     // Use output schema directly
     temperature: request.constraints.temperature || 0.3,
-    maxTokens: request.constraints.maxTokens,
+    maxOutputTokens: request.constraints.maxOutputTokens,
     signal: request.signal
   });
   return response.output;
@@ -3681,8 +3686,19 @@ function estimateTokens(text) {
 var MAX_SESSION_MEMORY_KEYS = 25;
 var MAX_MEMORY_TOKENS = 32e3;
 var MAX_SINGLE_ENTRY_TOKENS = 2e3;
+var MAX_TOOL_RESULT_TOKENS = 4e3;
 
 // ../core/src/execution/engine/agent/memory/manager.ts
+function truncateToolResult(content, maxTokens) {
+  const estimated = estimateTokens(content);
+  if (estimated <= maxTokens) return content;
+  const maxChars = Math.floor(maxTokens * 3.5);
+  const truncated = content.slice(0, maxChars);
+  const omitted = estimated - maxTokens;
+  return truncated + `
+
+[Response truncated \u2014 estimated ${omitted} tokens omitted. Use more specific filters to get smaller results.]`;
+}
 var MemoryManager = class {
   constructor(memory, constraints = {}, logger) {
     this.memory = memory;
@@ -3750,17 +3766,31 @@ var MemoryManager = class {
    */
   addToHistory(entry) {
     if (entry.turnNumber === void 0 && entry.type !== "context") {
-      throw new AgentMemoryValidationError(
-        "turnNumber required for history entries (use null for session memory)",
-        {
-          entryType: entry.type,
-          missingField: "turnNumber",
-          iterationNumber: entry.iterationNumber
-        }
-      );
+      throw new AgentMemoryValidationError("turnNumber required for history entries (use null for session memory)", {
+        entryType: entry.type,
+        missingField: "turnNumber",
+        iterationNumber: entry.iterationNumber
+      });
+    }
+    let content = entry.content;
+    if (entry.type === "tool-result") {
+      const before = content;
+      content = truncateToolResult(content, MAX_TOOL_RESULT_TOKENS);
+      if (content !== before) {
+        const truncateTime = Date.now();
+        this.logger?.action(
+          "memory-tool-result-truncate",
+          `Tool result truncated (${estimateTokens(before)} -> ${MAX_TOOL_RESULT_TOKENS} tokens)`,
+          entry.iterationNumber ?? 0,
+          truncateTime,
+          truncateTime,
+          0
+        );
+      }
     }
     this.memory.history.push({
       ...entry,
+      content,
       timestamp: Date.now()
     });
     this.autoCompact();
@@ -4416,7 +4446,7 @@ var Agent = class {
         memoryContext: this.memoryManager.toContext(this.iterationNumber, this.executionContext?.sessionTurnNumber),
         outputSchema,
         constraints: {
-          maxTokens: this.modelConfig.maxTokens,
+          maxOutputTokens: this.modelConfig.maxOutputTokens,
           temperature
         },
         model: this.modelConfig.model,
@@ -4742,7 +4772,7 @@ var PostMessageLLMAdapter = class {
         messages: request.messages,
         responseSchema: request.responseSchema,
         temperature: request.temperature,
-        maxTokens: request.maxTokens
+        maxOutputTokens: request.maxOutputTokens
       }
     });
     return { output: result };
@@ -4908,7 +4938,10 @@ var scheduler = createAdapter("scheduler", [
 
 // src/worker/adapters/llm.ts
 var llm = {
-  generate: (params) => platform.call({ tool: "llm", method: "generate", params })
+  generate: async (params) => {
+    const result = await platform.call({ tool: "llm", method: "generate", params });
+    return { output: result };
+  }
 };
 
 // src/worker/adapters/storage.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {

package/reference/framework/agent.mdx

@@ -73,15 +73,15 @@ The `/docs` command manages the permanent `docs/` tree -- everything except `doc
 
 ### `/work` Command
 
-The `/work` command manages in-progress task tracking across sessions. It uses `docs/in-progress/` for task documents with standardized frontmatter (`status: planned | in-progress | complete`). Operations:
+The `/work` command manages in-progress task tracking across sessions. It uses `docs/in-progress/` for task documents with standardized frontmatter (`status: planned | in-progress | complete`).
 
-- **`/work`** (no arguments) -- Numbered list sorted by status (`in-progress` first) with last-saved date and current step. Pick by number to auto-resume.
-- **`/work create`** -- Guided interview (5 questions) covering objective, acceptance criteria, relation to existing work, investigation needed, and placement. New docs start with `status: planned`. Placement is determined intelligently: related directory, new directory for multi-file tasks, flat file for small tasks.
-- **`/work save`** -- Comprehensive snapshot: progress markers, files modified table, key docs to read on resume, and a copy-pasteable "To continue" prompt. Proactively suggested before context pressure builds.
-- **`/work resume [<name>]`** -- Load a task by number, keyword, or auto-detect. Loads key docs in parallel and verifies referenced files exist. No file paths required.
-- **`/work complete`** -- Seven-step pipeline: resolve target, validate readiness, clean doc (strip resume context, remove progress markers, target 200-400 lines), determine destination in `docs/`, confirm with user, move, verify.
+`/work` is intent-driven -- the agent detects what to do from context rather than requiring explicit subcommands:
 
-When all plan steps for a task are marked COMPLETE and the user appears to be moving on, the agent proactively suggests running `/work complete`.
+- **`/work`** (no arguments) -- Lists tasks sorted by status (`in-progress` first) with last-saved date and current step. Pick by number or name to auto-resume, or describe new work to auto-create a task.
+- **Auto-create** -- When the user describes work that doesn't match an existing task, the agent creates a task doc automatically. If intent is clear, it skips the interview; if ambiguous, it asks 1-2 focused questions.
+- **Auto-save** -- The agent saves progress silently when the conversation context is getting heavy, the user is wrapping up, or 2+ steps have been completed without saving. Updates progress markers, files modified, and resume context.
+- **Auto-resume** -- When the user picks an existing task (by number, name, or keyword), the agent loads context and resumes automatically.
+- **Suggest complete** -- When all plan steps are marked COMPLETE, the agent suggests finalizing: "All steps for '`{task}`' look done. Want me to finalize it?" It never auto-invokes completion. The complete flow validates readiness, cleans the doc (strips resume context, removes progress markers, targets 200-400 lines), determines destination in `docs/`, confirms with user, moves, and verifies.
 
 **Directory conventions for `docs/in-progress/`:**
 

package/reference/framework/index.mdx

@@ -21,7 +21,7 @@ Running `elevasis-sdk init my-project` produces the following agent infrastructu
 │   ├── tutorial.md             # Progressive learning path (3 tracks)
 │   └── work.md                 # Task tracking
 ├── hooks/
-│   └── enforce-sdk-boundary.mjs  # Blocks destructive git, gh CLI, external writes
+│   └── enforce-sdk-boundary.mjs  # Blocks file modifications outside project boundary
 ├── skills/
 │   └── creds/SKILL.md          # Credential management (auto-triggers)
 └── rules/
@@ -167,15 +167,15 @@ Section templates by doc type:
 
 **Command Routing Reference:**
 
-| Scenario                                | Command        |
-| --------------------------------------- | -------------- |
-| Starting new work                       | `/work create` |
-| Resuming yesterday's work               | `/work resume` |
-| Browsing what docs exist                | `/docs`        |
-| Creating a reference doc (not a task)   | `/docs create` |
-| Checking if docs match current code     | `/docs verify` |
-| Full maintenance pipeline (8 steps)     | `/meta fix`    |
-| Deploying code and auto-generating maps | `/meta deploy` |
+| Scenario                                | Command                                               |
+| --------------------------------------- | ----------------------------------------------------- |
+| Starting new work                       | `/work` (auto-detects new work from your description) |
+| Resuming yesterday's work               | `/work` (auto-resumes if one task is in-progress)     |
+| Browsing what docs exist                | `/docs`                                               |
+| Creating a reference doc (not a task)   | `/docs create`                                        |
+| Checking if docs match current code     | `/docs verify`                                        |
+| Full maintenance pipeline (8 steps)     | `/meta fix`                                           |
+| Deploying code and auto-generating maps | `/meta deploy`                                        |
 
 ---
 

package/reference/framework/project-structure.mdx

@@ -96,7 +96,7 @@ This file is NOT scaffolded by default. The agent creates it the first time you
 
 ### `docs/in-progress/`
 
-Work-in-progress task documents created by `/work create`. Each file represents an active work item with objective, plan, progress markers, and resume context. `/work complete` moves finished items to their permanent location in `docs/`.
+Work-in-progress task documents managed by `/work`. Each file represents an active work item with objective, plan, progress markers, and resume context. When all steps are complete, the agent suggests finalizing the task, which moves finished items to their permanent location in `docs/`.
 
 This directory is NOT deployed -- it is filtered out during the doc scan in `elevasis-sdk deploy`.
 
@@ -112,7 +112,7 @@ Only `src/` and `docs/` are scaffolded by `elevasis-sdk init`. The following dir
 | `src/example/`         | `elevasis-sdk init` (default)    | Always -- echo starter workflow lives here (replace with your own) |
 | `src/shared/`          | `elevasis-sdk init` (default)    | Always -- cross-domain shared utilities (starts empty)             |
 | `docs/`                | `elevasis-sdk init` (default)    | Always                                                             |
-| `docs/in-progress/`    | Agent (on first `/work create`)  | When you create a task doc for in-progress work                    |
+| `docs/in-progress/`    | Agent (on first `/work`)         | When you create a task doc for in-progress work                    |
 | `docs/project-map.mdx` | `elevasis-sdk deploy`            | Auto-generated on every deploy                                     |
 | `docs/priorities.mdx`  | Agent (on first goal discussion) | When you discuss project goals or priorities                       |
 | `data/`                | Agent (on demand)                | When you connect a database                                        |
@@ -224,7 +224,7 @@ The `.claude/commands/` directory contains four commands covering the core devel
 
 - **`/meta`** -- Project lifecycle: init, status, fix, deploy, health
 - **`/docs`** -- Browse, create, and verify permanent documentation
-- **`/work`** -- Task tracking across sessions: list, create, save, resume, complete
+- **`/work`** -- Task tracking across sessions: auto-detects intent (create, save, resume); suggests complete
 - **`/tutorial`** -- Progressive learning path adapted to your skill profile
 
 For detailed command documentation, see [Agent System](agent).

package/reference/getting-started.mdx

@@ -31,7 +31,7 @@ my-project/
 │   │   ├── tutorial.md             # Progressive learning
 │   │   └── work.md                 # Task tracking
 │   ├── hooks/
-│   │   └── enforce-sdk-boundary.mjs # Blocks destructive commands (auto-loaded)
+│   │   └── enforce-sdk-boundary.mjs # Blocks file modifications outside project (auto-loaded)
 │   ├── scripts/
 │   │   └── statusline-command.js   # Dynamic status line script
 │   ├── skills/