crow-central-agency 0.27.2 → 0.27.4

package/dist/_shared/index.js

@@ -2,11 +2,12 @@ export { CLAUDE_MODELS, GITHUB_COPILOT_MODELS, CLAUDE_CODE_MODEL_OPTIONS, ModelO
 export { SchedulerTimeSchema, DAY_OF_WEEK, DayOfWeekSchema, TimeModeSchema, TIME_MODE, } from "./schemas/scheduler.schema.js";
 export { createApiSuccessSchema, ApiErrorSchema, } from "./schemas/api-response.schema.js";
 export { SessionUsageSchema, PendingPermissionInfoSchema, PendingInstructionReminderSchema, AgentRuntimeStateSchema, AgentActivitySchema, AGENT_ACTIVITY_TYPE, AGENT_STATUS, MAX_INPUT_HISTORY, } from "./schemas/agent-runtime-state.schema.js";
-export { ClientMessageSchema, ServerMessageSchema, SendMessageSchema, InjectMessageSchema, PermissionResponseWsSchema, CommandMessageSchema, AgentTextWsMessageSchema, AgentActivityWsMessageSchema, AgentResultWsMessageSchema, AgentStatusWsMessageSchema, AgentCreatedWsMessageSchema, AgentUpdatedWsMessageSchema, AgentDeletedWsMessageSchema, AgentUsageWsMessageSchema, PermissionRequestWsMessageSchema, PermissionCancelledWsMessageSchema, ErrorWsMessageSchema, AgentMessageWsMessageSchema, AgentToolProgressWsMessageSchema, TaskAddedWsMessageSchema, TaskUpdatedWsMessageSchema, TaskAssignedWsMessageSchema, TaskStateChangedWsMessageSchema, TaskDeletedWsMessageSchema, CircleCreatedWsMessageSchema, CircleUpdatedWsMessageSchema, CircleDeletedWsMessageSchema, RelationshipCreatedWsMessageSchema, RelationshipDeletedWsMessageSchema, FragmentCreatedWsMessageSchema, FragmentUpdatedWsMessageSchema, FragmentDeletedWsMessageSchema, AgentBuilderDraftUpdatedWsMessageSchema, isAgentServerMessage, isAgentLifecycleServerMessage, CLIENT_MESSAGE_TYPE, SERVER_MESSAGE_TYPE, } from "./schemas/websocket.schema.js";
+export { ClientMessageSchema, ServerMessageSchema, SendMessageSchema, InjectMessageSchema, PermissionResponseWsSchema, ResolveQuestionWsSchema, CommandMessageSchema, AgentTextWsMessageSchema, AgentActivityWsMessageSchema, AgentResultWsMessageSchema, AgentStatusWsMessageSchema, AgentCreatedWsMessageSchema, AgentUpdatedWsMessageSchema, AgentDeletedWsMessageSchema, AgentUsageWsMessageSchema, PermissionRequestWsMessageSchema, PermissionCancelledWsMessageSchema, QuestionRequestWsMessageSchema, QuestionResolvedWsMessageSchema, ErrorWsMessageSchema, AgentMessageWsMessageSchema, AgentToolProgressWsMessageSchema, TaskAddedWsMessageSchema, TaskUpdatedWsMessageSchema, TaskAssignedWsMessageSchema, TaskStateChangedWsMessageSchema, TaskDeletedWsMessageSchema, CircleCreatedWsMessageSchema, CircleUpdatedWsMessageSchema, CircleDeletedWsMessageSchema, RelationshipCreatedWsMessageSchema, RelationshipDeletedWsMessageSchema, FragmentCreatedWsMessageSchema, FragmentUpdatedWsMessageSchema, FragmentDeletedWsMessageSchema, AgentBuilderDraftUpdatedWsMessageSchema, isAgentServerMessage, isAgentLifecycleServerMessage, CLIENT_MESSAGE_TYPE, SERVER_MESSAGE_TYPE, } from "./schemas/websocket.schema.js";
 export { PERMISSION_DECISION, PermissionRequestSchema, PermissionResponseSchema, } from "./schemas/permission.schema.js";
+export { ASK_USER_QUESTION_TOOL_NAME, QUESTION_SUBMISSION_KIND, AskUserQuestionOptionSchema, AskUserQuestionItemSchema, AskUserQuestionSchema, PendingQuestionInfoSchema, QuestionAnswerSchema, QuestionAnswersSubmissionSchema, QuestionResponseSubmissionSchema, QuestionSubmissionSchema, AskUserQuestionAnswersInputSchema, AskUserQuestionResponseInputSchema, AskUserQuestionResolvedInputSchema, } from "./schemas/ask-user-question.schema.js";
 export { AgentMessageSchema, MessageAnnotationSchema, AGENT_MESSAGE_ROLE, AGENT_MESSAGE_TYPE, } from "./schemas/agent-message.schema.js";
 export { ARTIFACT_TYPE, ARTIFACT_CONTENT_TYPE, ArtifactTypeSchema, ArtifactContentTypeSchema, ArtifactEntityTypeSchema, ArtifactMetadataSchema, ArtifactUpdateSchema, } from "./schemas/artifact.schema.js";
-export { AGENT_TASK_STATE, AGENT_TASK_SOURCE_TYPE, AgentTaskStateSchema, AgentTaskSourceSchema, AgentTaskItemSchema, AgentTaskDatabaseSchema, CreateTaskInputSchema, UpdateTaskInputSchema, UpdateTaskStateInputSchema, AssignTaskInputSchema, } from "./schemas/agent-task.schema.js";
+export { AGENT_TASK_STATE, AGENT_TASK_SOURCE_TYPE, AgentTaskStateSchema, AgentTaskSourceSchema, AgentTaskItemSchema, AgentTaskDatabaseSchema, CreateTaskInputSchema, UpdateTaskInputSchema, UpdateTaskResultInputSchema, UpdateTaskStateInputSchema, AssignTaskInputSchema, } from "./schemas/agent-task.schema.js";
 export { MCP_CONFIG_TYPE, InternalMcpConfigSchema, McpServerConfigSchema, CreateMcpConfigInputSchema, UpdateMcpConfigInputSchema, } from "./schemas/mcp-config.schema.js";
 export { SensorInfoSchema } from "./schemas/sensor.schema.js";
 export { AddFeedInputSchema, DetectFeedsInputSchema, } from "./schemas/feed.schema.js";

package/dist/_shared/schemas/agent-runtime-state.schema.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { MessageSourceSchema } from "./message-source.schema.js";
+import { PendingQuestionInfoSchema } from "./ask-user-question.schema.js";
 /** Maximum number of recent user inputs retained per agent for compose-box recall. */
 export const MAX_INPUT_HISTORY = 30;
 export const AGENT_STATUS = {
@@ -83,6 +84,7 @@ export const AgentRuntimeStateSchema = z.object({
     lastGmailCheckTimestamp: z.number().optional(),
     lastError: z.string().optional(),
     pendingPermissions: z.array(PendingPermissionInfoSchema).optional(),
+    pendingQuestion: PendingQuestionInfoSchema.optional(),
     pendingInstructionReminder: PendingInstructionReminderSchema.optional(),
     inputHistory: z.array(z.string()).optional(),
 });

package/dist/_shared/schemas/agent-task.schema.js

@@ -70,6 +70,13 @@ export const CreateTaskInputSchema = z.object({
 export const UpdateTaskInputSchema = z.object({
     task: z.string().min(1, "Task description is required"),
 });
+/**
+ * Input for saving a draft result on an OPEN task without changing its state.
+ * Empty string is a legitimate value (clears the draft).
+ */
+export const UpdateTaskResultInputSchema = z.object({
+    taskResult: z.string(),
+});
 /**
  * Input for transitioning a task to a new state via REST.
  * Only includes states reachable by user action. OPEN is the initial
@@ -77,6 +84,7 @@ export const UpdateTaskInputSchema = z.object({
  */
 export const UpdateTaskStateInputSchema = z.object({
     state: z.enum([AGENT_TASK_STATE.INCOMPLETE, AGENT_TASK_STATE.COMPLETED, AGENT_TASK_STATE.CLOSED]),
+    taskResult: z.string().optional(),
 });
 /** Input for assigning a task. Accepts the owner source (who will handle the task). */
 export const AssignTaskInputSchema = z.object({

package/dist/_shared/schemas/ask-user-question.schema.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+/** The Claude SDK tool name whose `canUseTool` call parks for a user answer. */
+export const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
+/**
+ * A single selectable option within a question. `preview` is a sanitized HTML fragment, present only
+ * because the query sets `previewFormat: "html"`; options may omit it.
+ */
+export const AskUserQuestionOptionSchema = z.object({
+    label: z.string(),
+    description: z.string(),
+    preview: z.string().optional(),
+});
+/** One question in an AskUserQuestion set, with its options and select mode. */
+export const AskUserQuestionItemSchema = z.object({
+    question: z.string(),
+    header: z.string(),
+    multiSelect: z.boolean(),
+    options: z.array(AskUserQuestionOptionSchema),
+});
+/** The validated `canUseTool` input for the AskUserQuestion tool (SDK input is advisory; we parse it). */
+export const AskUserQuestionSchema = z.object({
+    questions: z.array(AskUserQuestionItemSchema),
+});
+/**
+ * Pending question metadata persisted on runtime state so the frontend recovers it on refresh.
+ * Single slot — the paused query allows at most one in-flight question per agent.
+ */
+export const PendingQuestionInfoSchema = z.object({
+    toolUseId: z.string(),
+    questions: z.array(AskUserQuestionItemSchema),
+});
+/** How a parked question is resolved: per-question selections, or a freeform reply. */
+export const QUESTION_SUBMISSION_KIND = {
+    ANSWERS: "answers",
+    RESPONSE: "response",
+};
+/**
+ * A single answer keyed by question index (question text is a fragile wire key; the backend owns the
+ * text mapping). `value` is one label for single-select/free-text, or many for multi-select.
+ */
+export const QuestionAnswerSchema = z.object({
+    questionIndex: z.number().int().nonnegative(),
+    value: z.union([z.string(), z.array(z.string())]),
+});
+/** Per-question answers submission — the index-keyed selections the user made. */
+export const QuestionAnswersSubmissionSchema = z.object({
+    toolUseId: z.string(),
+    kind: z.literal(QUESTION_SUBMISSION_KIND.ANSWERS),
+    answers: z.array(QuestionAnswerSchema),
+});
+/** Freeform response submission — dismiss / general reply, valid regardless of per-question completeness. */
+export const QuestionResponseSubmissionSchema = z.object({
+    toolUseId: z.string(),
+    kind: z.literal(QUESTION_SUBMISSION_KIND.RESPONSE),
+    response: z.string(),
+});
+/** UI -> backend submission resolving a parked question. */
+export const QuestionSubmissionSchema = z.discriminatedUnion("kind", [
+    QuestionAnswersSubmissionSchema,
+    QuestionResponseSubmissionSchema,
+]);
+/**
+ * Resolved `updatedInput` returned to the SDK for a per-question answers submission. `answers` is
+ * text-keyed (`questions[i].question` -> value), the shape the tool expects.
+ */
+export const AskUserQuestionAnswersInputSchema = z.object({
+    questions: z.array(AskUserQuestionItemSchema),
+    answers: z.record(z.string(), z.union([z.string(), z.array(z.string())])),
+});
+/** Resolved `updatedInput` returned to the SDK for a freeform response submission. */
+export const AskUserQuestionResponseInputSchema = z.object({
+    questions: z.array(AskUserQuestionItemSchema),
+    response: z.string(),
+});
+/** The backend-assembled `updatedInput` handed back to the paused SDK query. */
+export const AskUserQuestionResolvedInputSchema = z.union([
+    AskUserQuestionAnswersInputSchema,
+    AskUserQuestionResponseInputSchema,
+]);
+//# sourceMappingURL=ask-user-question.schema.js.map

package/dist/_shared/schemas/websocket.schema.js

@@ -8,6 +8,7 @@ import { AGENT_STATUS, AgentActivitySchema } from "./agent-runtime-state.schema.
 import { MessageSourceSchema } from "./message-source.schema.js";
 import { AgentCommandSchema } from "./agent-command.schema.js";
 import { AgentBuilderDraftViewSchema } from "./agent-builder.schema.js";
+import { AskUserQuestionItemSchema, QUESTION_SUBMISSION_KIND, QuestionAnswerSchema, } from "./ask-user-question.schema.js";
 /**
  * WebSocket message types - Client -> Server
  */
@@ -15,6 +16,7 @@ export const CLIENT_MESSAGE_TYPE = {
     SEND_MESSAGE: "send_message",
     INJECT_MESSAGE: "inject_message",
     PERMISSION_RESPONSE: "permission_response",
+    RESOLVE_QUESTION: "resolve_question",
     COMMAND: "command",
 };
 /**
@@ -31,6 +33,8 @@ export const SERVER_MESSAGE_TYPE = {
     AGENT_USAGE: "agent_usage",
     PERMISSION_REQUEST: "permission_request",
     PERMISSION_CANCELLED: "permission_cancelled",
+    QUESTION_REQUEST: "question_request",
+    QUESTION_RESOLVED: "question_resolved",
     ERROR: "error",
     AGENT_MESSAGE: "agent_message",
     AGENT_TOOL_PROGRESS: "agent_tool_progress",
@@ -66,6 +70,17 @@ export const PermissionResponseWsSchema = z.object({
     decision: z.enum([PERMISSION_DECISION.ALLOW, PERMISSION_DECISION.DENY, PERMISSION_DECISION.ALLOW_ALWAYS]),
     message: z.string().optional(),
 });
+/**
+ * Resolve a parked AskUserQuestion. `answers`/`response` are loosely optional here; the strict xor is
+ * enforced by re-parsing into the question submission union at the routing boundary.
+ */
+export const ResolveQuestionWsSchema = z.object({
+    type: z.literal(CLIENT_MESSAGE_TYPE.RESOLVE_QUESTION),
+    toolUseId: z.string(),
+    kind: z.enum([QUESTION_SUBMISSION_KIND.ANSWERS, QUESTION_SUBMISSION_KIND.RESPONSE]),
+    answers: z.array(QuestionAnswerSchema).optional(),
+    response: z.string().optional(),
+});
 export const CommandMessageSchema = z.object({
     type: z.literal(CLIENT_MESSAGE_TYPE.COMMAND),
     agentId: z.string(),
@@ -76,6 +91,7 @@ export const ClientMessageSchema = z.discriminatedUnion("type", [
     SendMessageSchema,
     InjectMessageSchema,
     PermissionResponseWsSchema,
+    ResolveQuestionWsSchema,
     CommandMessageSchema,
 ]);
 export const AgentTextWsMessageSchema = z.object({
@@ -137,6 +153,17 @@ export const PermissionCancelledWsMessageSchema = z.object({
     agentId: z.string(),
     toolUseId: z.string(),
 });
+export const QuestionRequestWsMessageSchema = z.object({
+    type: z.literal(SERVER_MESSAGE_TYPE.QUESTION_REQUEST),
+    agentId: z.string(),
+    toolUseId: z.string(),
+    questions: z.array(AskUserQuestionItemSchema),
+});
+export const QuestionResolvedWsMessageSchema = z.object({
+    type: z.literal(SERVER_MESSAGE_TYPE.QUESTION_RESOLVED),
+    agentId: z.string(),
+    toolUseId: z.string(),
+});
 export const ErrorWsMessageSchema = z.object({
     type: z.literal(SERVER_MESSAGE_TYPE.ERROR),
     agentId: z.string().optional(),
@@ -224,6 +251,8 @@ export const ServerMessageSchema = z.discriminatedUnion("type", [
     AgentUsageWsMessageSchema,
     PermissionRequestWsMessageSchema,
     PermissionCancelledWsMessageSchema,
+    QuestionRequestWsMessageSchema,
+    QuestionResolvedWsMessageSchema,
     ErrorWsMessageSchema,
     AgentMessageWsMessageSchema,
     AgentToolProgressWsMessageSchema,

package/dist/mcp/agents/agents-mcp-server.js

@@ -1,6 +1,7 @@
 import { defineMcpTool } from "../crow-mcp-manager-utils.js";
 import { getListAgentsToolConfig } from "./list-agents.js";
 import { getInvokeAgentToolConfig } from "./invoke-agent.js";
+import { getNotifyUserToolConfig } from "./notify-user.js";
 import { getSearchWorkspaceToolConfig } from "./search-workspace.js";
 import { CROW_NARRATIVE_ARCHITECT_AGENT_ID, CROW_WORLD_BUILDER_AGENT_ID, FRAGMENT_REFLECTION_AGENT_ID, } from "../../_shared/index.js";
 export const CROW_AGENTS_MCP_SERVER_NAME = "crow-agents";
@@ -11,6 +12,7 @@ export function getAgentsMcpServerDefinition(registry, runtimeManager, taskManag
         getTools: (agentId) => [
             defineMcpTool(getListAgentsToolConfig(agentId, registry)),
             defineMcpTool(getInvokeAgentToolConfig(agentId, registry, runtimeManager, taskManager)),
+            defineMcpTool(getNotifyUserToolConfig(agentId, taskManager)),
             defineMcpTool(getSearchWorkspaceToolConfig(agentId, documentSearchService, taskManager, circleManager, fragmentManager)),
         ],
     };

package/dist/mcp/agents/notify-user.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { trace } from "@opentelemetry/api";
+import { AGENT_TASK_SOURCE_TYPE } from "../../_shared/index.js";
+import { getErrorToolResult, textToolResult } from "../tool-utils.js";
+export const NOTIFY_USER_TOOL_NAME = "notify_user";
+export function getNotifyUserToolConfig(agentId, taskManager) {
+    const inputSchema = {
+        note: z
+            .string()
+            .min(1)
+            .describe("A clear, self-contained note for the user. Include everything they need to act or decide, since they do not share your conversation history"),
+    };
+    const handler = async ({ note }) => {
+        const trimmedNote = note.trim();
+        if (!trimmedNote) {
+            return textToolResult(["Error: note cannot be empty"], true);
+        }
+        try {
+            await taskManager.addTask(trimmedNote, { sourceType: AGENT_TASK_SOURCE_TYPE.AGENT, agentId }, { sourceType: AGENT_TASK_SOURCE_TYPE.USER });
+            trace.getActiveSpan()?.addEvent("notify_user", { "source.agent_id": agentId });
+            return textToolResult([
+                "Your note has been delivered to the user. This is fire-and-forget — do not wait for a reply.",
+                "If the user responds or dismisses it, you will be notified separately.",
+            ]);
+        }
+        catch (error) {
+            return getErrorToolResult(error, "Failed to notify user.");
+        }
+    };
+    const config = {
+        name: NOTIFY_USER_TOOL_NAME,
+        description: "Surface a note to the user — an actionable item or a question needing their decision. Use only for items that genuinely need the user's attention. This is fire-and-forget: do not wait for a reply; if the user responds you will be notified separately.",
+        inputSchema,
+        handler,
+    };
+    return config;
+}
+//# sourceMappingURL=notify-user.js.map

package/dist/public/assets/architecture-7EHR7CIX-BLDTKZff.js

@@ -0,0 +1 @@
+import"./chunk-NNHCCRGN-DlpIbxXb.js";import{x as e}from"./mermaid-parser.core-BIrsRvbQ.js";export{e as createArchitectureServices};