gestalt-mobile 0.17.2 → 0.18.0

package/dist/server/server/platform/persistence/sqlite-session-repository.js

@@ -11,8 +11,8 @@ export class SqliteSessionRepository {
     }
     save(session) {
         this.db
-            .prepare('INSERT INTO relay_sessions (id,workspace_id,workspace_path,profile,model,branch,thread_id,state,desired_state,active_turn_id,protocol_version,failure_count,effective_skill_selection_json,last_org_plan_json,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET workspace_id=excluded.workspace_id,workspace_path=excluded.workspace_path,profile=excluded.profile,model=excluded.model,branch=excluded.branch,thread_id=excluded.thread_id,state=excluded.state,desired_state=excluded.desired_state,active_turn_id=excluded.active_turn_id,protocol_version=excluded.protocol_version,failure_count=excluded.failure_count,effective_skill_selection_json=excluded.effective_skill_selection_json,last_org_plan_json=excluded.last_org_plan_json,updated_at=excluded.updated_at')
-            .run(session.id, session.workspaceId, session.workspacePath, session.profile, session.model ?? null, session.branch ?? null, session.threadId, session.state, session.desiredState, session.activeTurnId, session.protocolVersion, session.failureCount, session.effectiveSkillSelection === undefined
+            .prepare('INSERT INTO relay_sessions (id,workspace_id,workspace_path,profile,model,branch,thread_id,state,desired_state,active_turn_id,protocol_version,attention_tool_capability,failure_count,effective_skill_selection_json,last_org_plan_json,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET workspace_id=excluded.workspace_id,workspace_path=excluded.workspace_path,profile=excluded.profile,model=excluded.model,branch=excluded.branch,thread_id=excluded.thread_id,state=excluded.state,desired_state=excluded.desired_state,active_turn_id=excluded.active_turn_id,protocol_version=excluded.protocol_version,attention_tool_capability=excluded.attention_tool_capability,failure_count=excluded.failure_count,effective_skill_selection_json=excluded.effective_skill_selection_json,last_org_plan_json=excluded.last_org_plan_json,updated_at=excluded.updated_at')
+            .run(session.id, session.workspaceId, session.workspacePath, session.profile, session.model ?? null, session.branch ?? null, session.threadId, session.state, session.desiredState, session.activeTurnId, session.protocolVersion, session.attentionToolCapability ?? null, session.failureCount, session.effectiveSkillSelection === undefined
             ? null
             : JSON.stringify(session.effectiveSkillSelection), session.lastOrgPlan === undefined ? null : JSON.stringify(session.lastOrgPlan), session.createdAt, session.updatedAt);
     }
@@ -46,6 +46,9 @@ function map(row) {
         desiredState: row.desired_state,
         activeTurnId: row.active_turn_id,
         protocolVersion: row.protocol_version,
+        ...(row.attention_tool_capability === 'supported'
+            ? { attentionToolCapability: 'supported' }
+            : {}),
         failureCount: row.failure_count,
         ...(effectiveSkillSelection === undefined ? {} : { effectiveSkillSelection }),
         ...(lastOrgPlan === undefined ? {} : { lastOrgPlan }),

package/dist/server/shared/contracts/org-plan-attention.js

@@ -0,0 +1,101 @@
+/*
+ * Copyright (C) 2026 Dyne.org foundation
+ * Designed by Denis Roio <jaromil@dyne.org>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+/** Versioned, bounded contract consumed by supervised Org Plan roles. */
+export const GESTALT_ORG_PLAN_ATTENTION_TOOL_NAME = 'gestalt_org_plan_attention';
+export const orgPlanAttentionReasons = [
+    'planChange',
+    'hardBlock',
+    'missingDependency',
+    'permissionRequired',
+    'externalState',
+    'materialAmbiguity',
+];
+export const orgPlanAttentionResumeConditions = [
+    'userGuidance',
+    'planRevision',
+    'dependencyInstalled',
+    'permissionGranted',
+    'externalStateChanged',
+];
+export const gestaltOrgPlanAttentionDynamicTool = {
+    type: 'function',
+    name: GESTALT_ORG_PLAN_ATTENTION_TOOL_NAME,
+    description: 'Declare a genuine, durable human-attention requirement for a supervised Org Plan. Use only when progress cannot continue safely without the requested bounded human action. Do not include error stacks, environment values, plan contents, or unbounded prose.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['reason', 'summary', 'requestedAction', 'resumeCondition'],
+        properties: {
+            reason: { type: 'string', enum: orgPlanAttentionReasons },
+            summary: { type: 'string', minLength: 1, maxLength: 600 },
+            requestedAction: { type: 'string', minLength: 1, maxLength: 600 },
+            resumeCondition: { type: 'string', enum: orgPlanAttentionResumeConditions },
+        },
+    },
+};
+export function parseOrgPlanAttention(value) {
+    if (!isRecord(value) || Object.keys(value).length !== 4)
+        return null;
+    if (!isReason(value.reason) ||
+        !isBoundedText(value.summary, 600) ||
+        !isBoundedText(value.requestedAction, 600) ||
+        !isResumeCondition(value.resumeCondition))
+        return null;
+    return {
+        reason: value.reason,
+        summary: value.summary,
+        requestedAction: value.requestedAction,
+        resumeCondition: value.resumeCondition,
+    };
+}
+export function parseOrgPlanAttentionResponse(value) {
+    if (!isRecord(value) || !['resume', 'disableAutopilot'].includes(value.action))
+        return null;
+    if (Object.keys(value).some((key) => key !== 'action' && key !== 'guidance'))
+        return null;
+    if (value.guidance !== undefined && !isBoundedText(value.guidance, 1_000))
+        return null;
+    return {
+        action: value.action,
+        ...(typeof value.guidance === 'string' ? { guidance: value.guidance } : {}),
+    };
+}
+/** The only result accepted by the held app-server dynamic-tool request. */
+export function toOrgPlanAttentionToolResponse(response) {
+    return {
+        success: true,
+        contentItems: [{ type: 'input_text', text: JSON.stringify(response) }],
+    };
+}
+export function isOrgPlanAttentionToolResponse(value) {
+    if (!isRecord(value) || value.success !== true || !Array.isArray(value.contentItems))
+        return false;
+    const item = value.contentItems[0];
+    if (value.contentItems.length !== 1 ||
+        !isRecord(item) ||
+        item.type !== 'input_text' ||
+        typeof item.text !== 'string')
+        return false;
+    try {
+        return parseOrgPlanAttentionResponse(JSON.parse(item.text)) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+function isReason(value) {
+    return (typeof value === 'string' && orgPlanAttentionReasons.includes(value));
+}
+function isResumeCondition(value) {
+    return (typeof value === 'string' &&
+        orgPlanAttentionResumeConditions.includes(value));
+}
+function isBoundedText(value, maximum) {
+    return typeof value === 'string' && value.trim().length > 0 && value.length <= maximum;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt-mobile",
-  "version": "0.17.2",
+  "version": "0.18.0",
   "description": "Mobile-first web relay for durable Codex development sessions",
   "keywords": [
     "codex",