@xopcai/xopc 0.0.428 → 0.0.430

package/dist/src/memory-learning/source-learning.js

@@ -2,16 +2,16 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { claimContextExtractionRun, finishContextExtractionRun } from "../storage/sqlite/context-extraction-repository.js";
-import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
-import { learningPolicyHash } from "./repository.js";
 import { getActiveUnderstandingConsent, getUnderstandingConsent } from "../user-context/sources/consent-repository.js";
-import { resolveModelSelector } from "../config/agent-model-intents.js";
+import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
-import { isLoopbackModel } from "../providers/local-model.js";
-import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { resolveModelSelector } from "../config/agent-model-intents.js";
+import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { extractionInputHash } from "../user-context/extraction/registry.js";
+import { learningPolicyHash } from "./repository.js";
+import { isLoopbackModel } from "../providers/local-model.js";
 import { WorkCandidateSchema } from "./work-candidate.js";
 import { applyWorkCandidates } from "./work-capture.js";
 import { randomUUID } from "node:crypto";

package/dist/src/memory-learning/task-receipts.js

@@ -2,10 +2,10 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { createContextEvidence } from "../storage/sqlite/context-evidence-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { inferMemorySensitivity } from "../agent/memory/sensitivity.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { createHash } from "node:crypto";
 //#region src/memory-learning/task-receipts.ts
 init_session_repository();

package/dist/src/notes/agent-context.js

@@ -1,12 +1,12 @@
 import { getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
-import { extractDocumentText } from "../document-understanding/extract.js";
-import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
-import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
-import { transcribe } from "../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../voice/stt/availability.js";
+import { transcribe } from "../voice/stt/transcribe-core.js";
 import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
 import "../voice/stt/index.js";
+import { extractDocumentText } from "../document-understanding/extract.js";
+import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
+import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
 import { extname } from "node:path";
 import { readFile } from "node:fs/promises";
 //#region src/notes/agent-context.ts

package/dist/src/notes/index.js

@@ -1,5 +1,5 @@
-import { buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
 import { resolveNoteMediaDir, resolveNotesDir } from "./paths.js";
 import { NotesStore } from "./store.js";
+import { buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
 import { NotesService } from "./service.js";
 export { NotesService, NotesStore, buildNoteAgentContext, buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact, resolveNoteMediaDir, resolveNotesDir };

package/dist/src/notes/service.js

@@ -6,13 +6,13 @@ import { buildNoteAttachmentRef } from "./attachment-ref.js";
 import { parseNoteMarkdown } from "./note-markdown.js";
 import { listNoteProjectSummaries } from "../storage/sqlite/notes-repository.js";
 import { changedFieldsFromPatch, emitActivity, previewText, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
+import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
+import { revokeNoteShareRecords } from "../share/note-share-revocation.js";
+import { NotesStore } from "./store.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
-import { revokeNoteShareRecords } from "../share/note-share-revocation.js";
-import { NotesStore } from "./store.js";
-import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/notes/service.ts
 init_providers();

package/dist/src/observability/runtime.d.ts

@@ -55,3 +55,5 @@ export declare function testLangfuse(): Promise<boolean>;
 export declare function closeTracing(): Promise<void>;
 export declare function traceOperation<T>(name: string, fn: () => Promise<T>, attributes?: Attributes): Promise<T>;
 export declare function setTraceIdentity(identity: TraceIdentity): void;
+/** Keep the first timing for each milestone on the run root, including fallback runs. */
+export declare function recordTraceLatency(metrics: Record<string, number>): void;

package/dist/src/observability/runtime.js

@@ -400,5 +400,16 @@ function setTraceIdentity(identity) {
 	};
 	scope.root?.setAttributes(attrs(scope.identity, "agent"));
 }
+/** Keep the first timing for each milestone on the run root, including fallback runs. */
+function recordTraceLatency(metrics) {
+	const scope = scopes.getStore();
+	if (!scope?.root) return;
+	scope.metrics ??= /* @__PURE__ */ new Set();
+	for (const [name, value] of Object.entries(metrics)) {
+		if (!Number.isFinite(value) || value < 0 || scope.metrics.has(name)) continue;
+		scope.root.setAttribute(`xopc.latency.${name}`, value);
+		scope.metrics.add(name);
+	}
+}
 //#endregion
-export { closeTracing, configureTracing, flushTracing, localStore, setTraceIdentity, startObservation, testLangfuse, traceIds, traceOperation, traceRun, traceTools, tracingConfig, tracingStatus };
+export { closeTracing, configureTracing, flushTracing, localStore, recordTraceLatency, setTraceIdentity, startObservation, testLangfuse, traceIds, traceOperation, traceRun, traceTools, tracingConfig, tracingStatus };

package/dist/src/personal-agent/capability-service.js

@@ -1,10 +1,10 @@
 import { getConnectorInstallation, init_connector_repository, listConnectorConnections } from "../storage/sqlite/connector-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { isPersonalConversation } from "./repository.js";
 import { canAccessConnectorAccount, currentAccountConnections } from "../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../connectors/principal.js";
-import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
+import { isPersonalConversation } from "./repository.js";
 import { assessSpecialist } from "../agent-matching/service.js";
+import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
 //#region src/personal-agent/capability-service.ts
 init_repository();
 init_connector_repository();

package/dist/src/personal-agent/proactivity/routes.js

@@ -1,7 +1,7 @@
 import { PersonalFeedbackSchema, PersonalProactivitySettingsSchema, PersonalStrategyRollbackSchema } from "../../../packages/gateway-contract/src/personal-proactivity.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { getPersonalAgent } from "../repository.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { getProactivitySettings, listInterestCandidates, patchAttention, patchProactivitySettings, provenanceDetail, recordFeedback, rollbackStrategy, strategyState } from "./repository.js";
 import { z } from "zod";
 //#region src/personal-agent/proactivity/routes.ts

package/dist/src/personal-agent/proactivity/service.js

@@ -6,16 +6,16 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
 import { appendTranscriptEntry } from "../../storage/sqlite/transcript-repository.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
-import { getPersonalAgent } from "../repository.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
+import { getPersonalAgent } from "../repository.js";
 import { DurableState } from "../../storage/sqlite/durable-state.js";
-import { enqueueDue, enqueueWakeup, getAttention, getAttentionSources, getProactivitySettings, isQuiet, listAttention, localDay, preparationStrategy, recordFeedback, reserveModelCall, saveAttention, sourceFingerprint, userText } from "./repository.js";
-import { PERSONAL_PERSONA_GUIDANCE } from "../persona.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { personalConversationState } from "../conversation-state.js";
+import { PERSONAL_PERSONA_GUIDANCE } from "../persona.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { enqueueDue, enqueueWakeup, getAttention, getAttentionSources, getProactivitySettings, isQuiet, listAttention, localDay, preparationStrategy, recordFeedback, reserveModelCall, saveAttention, sourceFingerprint, userText } from "./repository.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/personal-agent/proactivity/service.ts

package/dist/src/personal-agent/prompt-context.js

@@ -1,16 +1,16 @@
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import "../storage/sqlite/index.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
-import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
-import "../knowledge-memory/index.js";
 import { getActiveAssertionForSlot } from "../user-model/repository.js";
-import { getProjectForSession } from "../projects/workspace.js";
-import { canUseAssertion } from "../user-model/usage-policy.js";
-import "../user-model/index.js";
 import { isPersonalConversation } from "./repository.js";
-import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
 import { listPersonalResults } from "./result-reader.js";
+import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
+import { canUseAssertion } from "../user-model/usage-policy.js";
+import "../user-model/index.js";
+import { getProjectForSession } from "../projects/workspace.js";
+import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
+import "../knowledge-memory/index.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 //#region src/personal-agent/prompt-context.ts
 const clip = (value, limit) => value && (value.length > limit ? `${value.slice(0, limit - 1)}…` : value);
 /** Keep complete JSON records and identifiers, even when the snapshot is incomplete. */

package/dist/src/personal-agent/prompts.js

@@ -1,7 +1,7 @@
-import { PERSONAL_EMOTIONAL_STYLE_RULE, PERSONAL_IDENTITY_CONTINUITY_RULE } from "./persona.js";
-import { PERSONAL_COMMUNICATION_RULES, PERSONAL_RELIABILITY_RULES } from "./communication.js";
 import { PERSONAL_DEFAULT_STYLE_RULES } from "./default-style.js";
 import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-style.js";
+import { PERSONAL_EMOTIONAL_STYLE_RULE, PERSONAL_IDENTITY_CONTINUITY_RULE } from "./persona.js";
+import { PERSONAL_COMMUNICATION_RULES, PERSONAL_RELIABILITY_RULES } from "./communication.js";
 //#region src/personal-agent/prompts.ts
 const DELEGATION_RULES = [
 	"Answer directly when your capabilities suffice. Otherwise call personal_task(command=\"submit\") with a short objective. For a self-contained current request send {command:\"submit\", objective:\"short outcome\", useOriginalRequest:true}; command is required. With this mode, the host copies its entire stored text, including exact constraints. Preserve sourceRefs and explicitly requested Agent/Skills. Use a concise complete description instead when earlier conversation must be synthesized. Submit before reading materials. The background Task Router selects and starts the executor. After the tool succeeds, reply only with a short confirmation such as \"Submitted; I will report the result here.\" in the conversation language, then finish. Do not restate any task details, files, requirements or acceptance criteria, and do not wait for the worker. Remain available for conversation.",

package/dist/src/personal-agent/reply-composer.js

@@ -10,23 +10,23 @@ import { appendTranscriptEntry, loadLlmMessagesForSession } from "../storage/sql
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { init_providers, resolveModel } from "../providers/index.js";
-import { completeWithResolvedCredentials } from "../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason } from "../providers/model-response.js";
-import { getPersonalAgentByConversation } from "./repository.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { getPersonalAgentByConversation } from "./repository.js";
+import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
-import { loadProfileBootstrapFiles } from "../agent/bootstrap/load-bootstrap-files.js";
 import { TaskCriterionReviewRepository } from "../tasks/task-criterion-review-repository.js";
-import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
 import { hasPersonalResultFileLinks, sanitizePersonalResultFileLinks } from "./result-file-links.js";
 import { taskInstructionSequence } from "../tasks/task-instruction-sequence.js";
-import { PERSONAL_PERSONA_GUIDANCE } from "./persona.js";
-import "../tasks/task-research-result.js";
-import { recordPersonalPerformance } from "./performance.js";
+import { init_providers, resolveModel } from "../providers/index.js";
+import { extractAssistantText, getAssistantMessageErrorReason } from "../providers/model-response.js";
+import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { PERSONAL_DEFAULT_STYLE_RULES } from "./default-style.js";
+import { recordPersonalPerformance } from "./performance.js";
+import "../tasks/task-research-result.js";
 import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-style.js";
 import { personalConversationState } from "./conversation-state.js";
+import { PERSONAL_PERSONA_GUIDANCE } from "./persona.js";
+import { loadProfileBootstrapFiles } from "../agent/bootstrap/load-bootstrap-files.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/personal-agent/reply-composer.ts

package/dist/src/personal-agent/request-delivery.js

@@ -7,11 +7,11 @@ import { init_session_instance_repository, readCurrentTranscriptId } from "../st
 import { TaskRunRepository, init_task_run_repository } from "../tasks/task-run-repository.js";
 import { getPersonalRequest, init_request_repository, updatePersonalRequest } from "./request-repository.js";
 import { appendTranscriptEntry, loadLlmMessagesForSession } from "../storage/sqlite/transcript-repository.js";
-import { getPersonalAgentByConversation } from "./repository.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { getPersonalAgentByConversation } from "./repository.js";
 import { warmPersonalResult } from "./result-reader.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { PersonalRequestResultSchema, renderPersonalRequestResult } from "./request-result.js";
 import { enqueuePersonalReply } from "./reply-composer.js";
 //#region src/personal-agent/request-delivery.ts

package/dist/src/personal-agent/request-service.js

@@ -13,21 +13,21 @@ import { getConnectorAccount, init_connector_account_repository } from "../stora
 import { getConnectorConnection, getConnectorInstallation, init_connector_repository, listConnectorConnections } from "../storage/sqlite/connector-repository.js";
 import { cancelConnectionObjective, init_connection_wait_repository, publishConnectionWait, requireSessionConnection } from "../storage/sqlite/connection-wait-repository.js";
 import { getUserProfileSnapshot } from "../user-model/profile.js";
-import { isPersonalConversation } from "./repository.js";
 import { resolveTaskLocale } from "../tasks/task-language.js";
 import { canAccessConnectorAccount } from "../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../connectors/principal.js";
-import { resolveConnectionCandidate } from "../connectors/connection-candidates.js";
+import { isPersonalConversation } from "./repository.js";
 import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
 import { TaskApplicationService } from "../tasks/task-application-service.js";
-import { resolveResponseLanguageForSession } from "../agent/prompt/response-language.js";
-import { defineTaskContract } from "../tasks/task-contract-definition.js";
-import "./communication.js";
+import { AgentSelectionRepository, selectionRequestHash } from "../agent-matching/selection-repository.js";
 import { assessSpecialist } from "../agent-matching/service.js";
+import { assertSpecialistEligible } from "../agent-matching/delegation-service.js";
+import { resolveConnectionCandidate } from "../connectors/connection-candidates.js";
+import { defineTaskContract } from "../tasks/task-contract-definition.js";
 import { personalCapabilities } from "./capability-service.js";
+import "./communication.js";
+import { resolveResponseLanguageForSession } from "../agent/prompt/response-language.js";
 import { abortEmbeddedRun } from "../agent/embedded/runs.js";
-import { AgentSelectionRepository, selectionRequestHash } from "../agent-matching/selection-repository.js";
-import { assertSpecialistEligible } from "../agent-matching/delegation-service.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/personal-agent/request-service.ts
 init_src();

package/dist/src/personal-agent/result-reader.js

@@ -7,10 +7,10 @@ import { init_session_instance_repository, readCurrentTranscriptId } from "../st
 import { init_request_repository, personalRequestForTask } from "./request-repository.js";
 import { getConnectorAccount, init_connector_account_repository } from "../storage/sqlite/connector-account-repository.js";
 import { getConnectorConnection, getConnectorInstallation, init_connector_repository } from "../storage/sqlite/connector-repository.js";
-import { isPersonalConversation } from "./repository.js";
 import { canAccessConnectorAccount } from "../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../connectors/principal.js";
 import { resolveMediaReference } from "../media/media-reference.js";
+import { isPersonalConversation } from "./repository.js";
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";

package/dist/src/personal-agent/service.js

@@ -2,11 +2,11 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { setSessionConfig } from "../storage/sqlite/config-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
-import { getAvailableModels, init_providers } from "../providers/index.js";
 import { getPersonalAgent, personalAgentId } from "./repository.js";
+import { getAvailableModels, init_providers } from "../providers/index.js";
 import { PERSONAL_MAIN_TOOL_IDS, PERSONAL_READ_TOOL_ALIASES } from "./policy.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getModelThinking } from "../providers/model-thinking.js";
 import { personalInstructions } from "./prompts.js";
 import { completePersonalOnboarding } from "./onboarding.js";

package/dist/src/phone/contracts.d.ts

@@ -3,6 +3,7 @@ import type { PhonePerformance } from './execution-trace.js';
 export declare const PhoneProfileSchema: z.ZodEnum<{
     "autoglm-phone-v1": "autoglm-phone-v1";
     "structured-phone-v1": "structured-phone-v1";
+    "structured-tools-phone-v1": "structured-tools-phone-v1";
     "doubao-seed-phone-v1": "doubao-seed-phone-v1";
     "gui-owl-phone-v1": "gui-owl-phone-v1";
 }>;
@@ -10,6 +11,7 @@ export declare const PhoneModelMetadataSchema: z.ZodObject<{
     profile: z.ZodEnum<{
         "autoglm-phone-v1": "autoglm-phone-v1";
         "structured-phone-v1": "structured-phone-v1";
+        "structured-tools-phone-v1": "structured-tools-phone-v1";
         "doubao-seed-phone-v1": "doubao-seed-phone-v1";
         "gui-owl-phone-v1": "gui-owl-phone-v1";
     }>;

package/dist/src/phone/contracts.js

@@ -6,6 +6,7 @@ var init_contracts = __esmMin((() => {
 	PhoneProfileSchema = z.enum([
 		"autoglm-phone-v1",
 		"structured-phone-v1",
+		"structured-tools-phone-v1",
 		"doubao-seed-phone-v1",
 		"gui-owl-phone-v1"
 	]);

package/dist/src/phone/model-adapter.d.ts

@@ -2,7 +2,7 @@ import { type PhoneAppAccess } from './app-access.js';
 import { type PhonePlan, type PhonePlanState } from './planning.js';
 import type { Config } from '../config/schema.js';
 import { type PhoneAction, type PhoneApplication, type PhoneDecision, type PhoneObservation, type PhoneCompletion, type PhoneTaskContract, type PhoneRequestedOutput } from './contracts.js';
-export declare function phoneModelProfile(model: unknown): "autoglm-phone-v1" | "structured-phone-v1" | "doubao-seed-phone-v1" | "gui-owl-phone-v1";
+export { phoneModelProfile } from './model-policy.js';
 export declare function validatePhoneModelChange(next: {
     primary: string;
 } | null | undefined, previous?: {

package/dist/src/phone/model-adapter.js

@@ -1,23 +1,21 @@
-import { PhoneDecisionSchema, PhoneError, PhoneModelMetadataSchema, init_contracts } from "./contracts.js";
+import { PhoneDecisionSchema, PhoneError, init_contracts } from "./contracts.js";
+import { init_model_policy, phoneModelProfile } from "./model-policy.js";
 import { getApiKey, init_providers, resolveModel } from "../providers/index.js";
 import { cloudCreditBudgetHeaders, reportCloudCreditError } from "../providers/xopc-cloud-credit-budget.js";
 import { currentPhoneTrace, measurePhonePhase } from "./execution-trace.js";
-import { phoneAllowsApp } from "./app-access.js";
+import { predictPhoneToolDecision } from "./structured-model.js";
 import { readPhoneModelResponse } from "./model-response.js";
 import { AutoGlmHistory, autoGlmSystemPrompt, buildAutoGlmMessages } from "./autoglm-protocol.js";
+import { phoneAllowsApp } from "./app-access.js";
 import { PHONE_PLANNING_RULES, PhonePlanSchema } from "./planning.js";
 import { phoneSemanticControls } from "./semantic-controls.js";
 import { guiPhonePrompt, parseDoubaoPhone, parseGuiOwlPhone } from "./gui-protocol.js";
 import { z } from "zod";
 import { performance } from "node:perf_hooks";
 //#region src/phone/model-adapter.ts
+init_model_policy();
 init_providers();
 init_contracts();
-function phoneModelProfile(model) {
-	const candidate = model;
-	const metadata = PhoneModelMetadataSchema.safeParse(candidate?.phoneUse);
-	return metadata.success && candidate?.api === "openai-completions" && candidate.input?.includes("image") ? metadata.data.profile : void 0;
-}
 function validatePhoneModelChange(next, previous) {
 	if (!next || next.primary === previous?.primary || next.primary === "phone-mock/settings-about") return;
 	try {
@@ -507,6 +505,31 @@ async function createPhoneModel(modelRef, config, agentId) {
 				transport: config.phone?.modelResponseMode ?? "json"
 			};
 			try {
+				if (profile === "structured-tools-phone-v1") {
+					metric.protocol = profile;
+					const deadline = AbortSignal.timeout(config.phone?.modelRequestTimeoutMs ?? 45e3);
+					try {
+						const requestSignal = AbortSignal.any([signal, deadline]);
+						requestSignal.throwIfAborted();
+						const currentKey = await getApiKey(model.provider, {
+							agentId,
+							appConfig: config
+						});
+						if (!currentKey) throw new PhoneError("PHONE_MODEL_KEY_MISSING", "Reconnect the model provider on the Gateway host");
+						const modelInput = {
+							...input,
+							enhancements: {
+								...input.enhancements,
+								hierarchicalPlanning: false
+							}
+						};
+						const instructions = `Operate the authorized Android phone using exactly one phone_decision function call. Coordinates are normalized to 0..1000 on both axes. Ground actions in the current screenshot and native UI. Use typeText only for a focused non-password editable field; mode replace changes existing contents, insert appends. Request needsUser for passwords, login, verification codes, CAPTCHA or an effect outside the authorized goal. Completion is a claim, verified separately by the host. ${input.readOnly ? PHONE_SCREEN_READING_RULES : PHONE_RECOVERY_RULES}${input.readingFields ? " Return the requested readingFields as a compact JSON object encoded in complete.summary, with exactly those keys and visible string values or null. Do not merge fields." : ""}${input.enhancements?.semanticControls ? ` ${PHONE_SEMANTIC_RULES}` : ""}`;
+						return await measurePhonePhase("model_request", () => predictPhoneToolDecision(model, currentKey, instructions, buildPhoneModelContext(modelInput), modelInput, requestSignal, metric, started));
+					} catch (error) {
+						if (!signal.aborted && deadline.aborted) throw new PhoneError("PHONE_MODEL_TIMEOUT", "Phone model request timed out; no action from this request was dispatched", 502);
+						throw error;
+					}
+				}
 				const nativeGui = profile === "doubao-seed-phone-v1" || profile === "gui-owl-phone-v1";
 				const modelInput = profile !== "structured-phone-v1" ? {
 					...input,

package/dist/src/phone/model-policy.d.ts

@@ -0,0 +1,4 @@
+/** Native phone protocols stay explicit; ordinary visual tool models use function calls. */
+export declare function phoneModelProfile(model: unknown): "autoglm-phone-v1" | "structured-phone-v1" | "structured-tools-phone-v1" | "doubao-seed-phone-v1" | "gui-owl-phone-v1";
+/** Generic visual models remain eligible for ordinary chat and vision pickers. */
+export declare function isDedicatedPhoneModel(model: unknown): boolean;

package/dist/src/phone/model-policy.js

@@ -0,0 +1,30 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { PhoneModelMetadataSchema, init_contracts } from "./contracts.js";
+import { init_constants } from "../providers/constants.js";
+//#region src/phone/model-policy.ts
+/** Native phone protocols stay explicit; ordinary visual tool models use function calls. */
+function phoneModelProfile(model) {
+	if (!model || typeof model !== "object") return void 0;
+	const value = model;
+	if (!Array.isArray(value.input) || !value.input.includes("image")) return void 0;
+	const compatibleApi = value.api === "openai-completions" || value.api === "openai-responses";
+	if (value.phoneUse !== void 0) {
+		const metadata = PhoneModelMetadataSchema.safeParse(value.phoneUse);
+		if (!metadata.success) return void 0;
+		return metadata.data.profile === "structured-tools-phone-v1" ? compatibleApi && value.supportsTools !== false ? metadata.data.profile : void 0 : value.api === "openai-completions" ? metadata.data.profile : void 0;
+	}
+	if (value.provider === "xopc-cloud" || value.baseUrl === "extension://provider-plugin" || value.computerUse || value.supportsTools === false) return void 0;
+	return compatibleApi ? "structured-tools-phone-v1" : void 0;
+}
+/** Generic visual models remain eligible for ordinary chat and vision pickers. */
+function isDedicatedPhoneModel(model) {
+	const value = model;
+	return Boolean(value?.phoneUse && phoneModelProfile(model) && value.phoneUse.profile !== "structured-tools-phone-v1");
+}
+var init_model_policy = __esmMin((() => {
+	init_constants();
+	init_contracts();
+}));
+//#endregion
+init_model_policy();
+export { init_model_policy, isDedicatedPhoneModel, phoneModelProfile };

package/dist/src/phone/repository.js

@@ -1,6 +1,6 @@
 import { PhoneDeviceSchema, PhoneError, init_contracts } from "./contracts.js";
-import { normalizePhoneAppAccess } from "./app-access.js";
 import { DurableState } from "../storage/sqlite/durable-state.js";
+import { normalizePhoneAppAccess } from "./app-access.js";
 import { randomUUID } from "node:crypto";
 //#region src/phone/repository.ts
 init_contracts();

package/dist/src/phone/runtime.js

@@ -4,6 +4,10 @@ import { MOCK_PHONE_MODEL, PhoneError, PhoneInputSchema, init_contracts } from "
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { PhoneExecutionTrace, currentPhoneTrace, measurePhonePhase } from "./execution-trace.js";
 import { phoneAllowsApp, phoneAppAccess } from "./app-access.js";
+import { advancePhonePlan, buildPhonePlan, createPhonePlanState } from "./planning.js";
+import { canDispatchPhoneAction, observationSignature, phoneCompletionSatisfied } from "./reliability.js";
+import { groundPhoneCoordinateAction, resolvePhoneSemanticAction } from "./semantic-controls.js";
+import { createPhoneModel, isAboutScreen } from "./model-adapter.js";
 import { nativePhoneOutput, updatePhoneFeedback } from "./task-feedback.js";
 import { PhoneFrameCache, PhoneOperationBudget } from "./live-state.js";
 import { PhoneInteractiveSession } from "./interactive-session.js";
@@ -13,10 +17,6 @@ import { AdbPhoneDriver, resolveAdbPath } from "./adb-driver.js";
 import { CloudPhones } from "./cloud-phones.js";
 import { PhoneLocationEnvironment } from "./location-environment.js";
 import { WirelessPhones } from "./wireless.js";
-import { advancePhonePlan, buildPhonePlan, createPhonePlanState } from "./planning.js";
-import { canDispatchPhoneAction, observationSignature, phoneCompletionSatisfied } from "./reliability.js";
-import { groundPhoneCoordinateAction, resolvePhoneSemanticAction } from "./semantic-controls.js";
-import { createPhoneModel, isAboutScreen } from "./model-adapter.js";
 import { PhoneRepository } from "./repository.js";
 import { phoneCompletionGuidance, phoneCompletionRecoveryHint } from "./completion-recovery.js";
 import { confirmPhoneFocusRecovery, phoneBackRecovery, phoneUnfocusedTypingHint, preparePhoneFocusRecovery } from "./recovery.js";

package/dist/src/phone/structured-model.d.ts

@@ -0,0 +1,6 @@
+import { type Api, type Model } from '@earendil-works/pi-ai/compat';
+import { type PhoneDecision } from './contracts.js';
+import type { PhoneModelMetric } from './execution-trace.js';
+import type { PhonePrediction } from './model-adapter.js';
+/** Use the shared provider client for API keys and ChatGPT OAuth without persisting screenshots. */
+export declare function predictPhoneToolDecision(model: Model<Api>, apiKey: string, instructions: string, context: unknown, input: PhonePrediction, signal: AbortSignal, metric: PhoneModelMetric, started: number): Promise<PhoneDecision>;

package/dist/src/phone/structured-model.js

@@ -0,0 +1,87 @@
+import { PhoneDecisionSchema, PhoneError, init_contracts } from "./contracts.js";
+import { z } from "zod";
+import { completeSimple } from "@earendil-works/pi-ai/compat";
+import { performance } from "node:perf_hooks";
+//#region src/phone/structured-model.ts
+init_contracts();
+const TOOL_NAME = "phone_decision";
+const invalid = () => new PhoneError("PHONE_MODEL_PROTOCOL", "Phone model returned an invalid or incomplete function call; no action was dispatched");
+/** Use the shared provider client for API keys and ChatGPT OAuth without persisting screenshots. */
+async function predictPhoneToolDecision(model, apiKey, instructions, context, input, signal, metric, started) {
+	const responses = model.api === "openai-responses";
+	const schema = z.object({ decision: input.readOnly ? z.union([PhoneDecisionSchema.options[1], PhoneDecisionSchema.options[2]]) : PhoneDecisionSchema }).strict();
+	const tool = {
+		name: TOOL_NAME,
+		description: "One authorized phone action, completion claim or request for user assistance.",
+		parameters: z.toJSONSchema(schema)
+	};
+	metric.transport = responses ? "responses-stream" : "chat-completions-stream";
+	signal.throwIfAborted();
+	metric.preparationMs = Math.round(performance.now() - started);
+	const result = await completeSimple(model, {
+		systemPrompt: instructions,
+		messages: [{
+			role: "user",
+			timestamp: Date.now(),
+			content: [{
+				type: "text",
+				text: JSON.stringify(context)
+			}, {
+				type: "image",
+				data: input.observation.frame.toString("base64"),
+				mimeType: "image/png"
+			}]
+		}],
+		tools: [tool]
+	}, {
+		apiKey,
+		maxTokens: Math.min(3e3, model.maxTokens ?? 3e3),
+		signal,
+		maxRetries: 0,
+		transport: "sse",
+		cacheRetention: "none",
+		onPayload(payload) {
+			const body = payload;
+			body.parallel_tool_calls = false;
+			body.tool_choice = responses ? {
+				type: "function",
+				name: TOOL_NAME
+			} : {
+				type: "function",
+				function: { name: TOOL_NAME }
+			};
+			if (responses) {
+				body.store = false;
+				body.stream = true;
+			}
+			metric.requestBytes = Buffer.byteLength(JSON.stringify(body));
+		},
+		onProviderStreamEvent(event) {
+			metric.responseBytes = (metric.responseBytes ?? 0) + Buffer.byteLength(JSON.stringify(event));
+			if (metric.responseBytes > 2 * 1024 * 1024) throw invalid();
+		},
+		onResponse(response) {
+			metric.httpStatus = response.status;
+			metric.firstByteMs = Math.round(performance.now() - started);
+		}
+	});
+	signal.throwIfAborted();
+	metric.finishReason = result.stopReason;
+	metric.promptTokens = result.usage?.input;
+	metric.completionTokens = result.usage?.output;
+	metric.totalTokens = result.usage?.totalTokens;
+	if (result.stopReason === "length") throw new PhoneError("PHONE_MODEL_TRUNCATED", "Phone model response was truncated; no action was dispatched");
+	if (result.stopReason !== "toolUse" || result.errorMessage) throw invalid();
+	const calls = result.content.filter((item) => item.type === "toolCall");
+	if (calls.length !== 1 || calls[0].name !== TOOL_NAME) throw invalid();
+	let decision;
+	try {
+		decision = schema.parse(calls[0].arguments).decision;
+	} catch {
+		throw invalid();
+	}
+	if (decision.kind === "action" && decision.action.type === "tapElement" && !input.enhancements?.semanticControls) throw invalid();
+	return decision;
+}
+//#endregion
+export { predictPhoneToolDecision };

package/dist/src/projects/index.js

@@ -1,13 +1,13 @@
 import { ProjectStore, slugifyProjectName } from "./project-store.js";
-import { getProjectForSession, getProjectWorkspacePathForSession, resolveProjectWorkspacePath } from "./workspace.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "./project-kind.js";
 import { bindSessionToProject, bindSessionsToProject, listProjectConversationIds, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectDeletionBlockedError, ProjectService, ProjectWorkspaceInUseError, ProjectWorkspaceInvalidError } from "./project-service.js";
+import { ProjectSkillError, ProjectSkillService } from "./project-skill-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "./project-agent.js";
 import { CODING_PROJECT_AGENT_ID, inferSuggestedProjectDefaultAgentId, suggestProjectDefaultAgentId } from "./project-agent-suggestion.js";
-import { ProjectSkillError, ProjectSkillService } from "./project-skill-service.js";
 import { buildProjectLoopOverview } from "./project-loop.js";
 import { bindAutomationToProject } from "./automation-bind.js";
 import { bindKnowledgeItemToProject } from "./knowledge-bind.js";
+import { getProjectForSession, getProjectWorkspacePathForSession, resolveProjectWorkspacePath } from "./workspace.js";
 export { CODING_PROJECT_AGENT_ID, ProjectDeletionBlockedError, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceInUseError, ProjectWorkspaceInvalidError, ProjectWorkspaceMissingError, bindAutomationToProject, bindKnowledgeItemToProject, bindSessionToProject, bindSessionsToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectExecutionMode, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectConversationIds, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindSessionFromProject, workspaceDirectoryExists };

package/dist/src/projects/project-agent-suggestion.js

@@ -1,5 +1,5 @@
-import { agentExists, init_resolve_route } from "../routing/resolve-route.js";
 import { inferProjectKind } from "./project-kind.js";
+import { agentExists, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/projects/project-agent-suggestion.ts
 init_resolve_route();
 const CODING_PROJECT_AGENT_ID = "coder";

package/dist/src/projects/project-service.js

@@ -2,12 +2,12 @@ import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/t
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import "../storage/sqlite/index.js";
 import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
-import { ExecutionEnvironmentStore } from "../execution-environments/store.js";
 import { ProjectStore } from "./project-store.js";
-import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { enqueueProjectChanged } from "./project-change-events.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { drainProjectWorkspaceCreation, queueProjectWorkspaceCreation } from "./project-workspace-creation.js";
+import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
+import { ExecutionEnvironmentStore } from "../execution-environments/store.js";
 import { listPendingProjectUnderstandingRuns } from "../work-discovery/repository.js";
 import { inferProjectExecutionMode } from "./project-kind.js";
 import { bindSessionToProject, listProjectConversationIds, unbindSessionFromProject } from "./session-bind.js";