deepline 0.3.301 → 0.3.303

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-event-search.ts

@@ -1032,6 +1032,88 @@ export async function setRuntimeEventDeferredProjection(
   }
 }
 
+export type RuntimeEventProjectionModes = {
+  runtimeScope: string;
+  deferred: boolean | null;
+  independent: boolean | null;
+  unavailableReason:
+    | 'projection_mode_readers_missing'
+    | 'deferred_projection_reader_missing'
+    | 'independent_projection_reader_missing'
+    | null;
+};
+
+/** Read installed operator modes without scanning or changing the outbox. */
+export async function readRuntimeEventProjectionModes(
+  client: PostgresSchedulerQueryClient,
+  runtimeScope: string,
+): Promise<RuntimeEventProjectionModes> {
+  const scope = requiredScope(runtimeScope);
+  const schema = quoteIdent(scope);
+  const installed = await client.query<{
+    deferred_installed: boolean;
+    independent_installed: boolean;
+  }>(
+    `SELECT to_regprocedure($1) IS NOT NULL AS deferred_installed,
+            to_regprocedure($2) IS NOT NULL AS independent_installed`,
+    [
+      `${schema}.defer_runtime_event_projection()`,
+      `${schema}.independent_runtime_event_projection()`,
+    ],
+  );
+  const readers = installed.rows[0];
+  if (
+    !readers ||
+    typeof readers.deferred_installed !== 'boolean' ||
+    typeof readers.independent_installed !== 'boolean'
+  ) {
+    throw new Error('Runtime projection mode lookup returned no reader state.');
+  }
+  const unavailableReason = readers.deferred_installed
+    ? readers.independent_installed
+      ? null
+      : 'independent_projection_reader_missing'
+    : readers.independent_installed
+      ? 'deferred_projection_reader_missing'
+      : 'projection_mode_readers_missing';
+  if (!readers.deferred_installed && !readers.independent_installed) {
+    return {
+      runtimeScope: scope,
+      deferred: null,
+      independent: null,
+      unavailableReason,
+    };
+  }
+  // An absent function cannot appear in the SQL, even in an unselected CASE.
+  const deferredExpression = readers.deferred_installed
+    ? `${schema}.defer_runtime_event_projection()`
+    : 'NULL::boolean';
+  const independentExpression = readers.independent_installed
+    ? `${schema}.independent_runtime_event_projection()`
+    : 'NULL::boolean';
+  const result = await client.query<{
+    deferred: boolean | null;
+    independent: boolean | null;
+  }>(
+    `SELECT ${deferredExpression} AS deferred,
+            ${independentExpression} AS independent`,
+  );
+  const modes = result.rows[0];
+  if (
+    !modes ||
+    (readers.deferred_installed && typeof modes.deferred !== 'boolean') ||
+    (readers.independent_installed && typeof modes.independent !== 'boolean')
+  ) {
+    throw new Error('Runtime projection mode lookup returned invalid values.');
+  }
+  return {
+    runtimeScope: scope,
+    deferred: modes.deferred,
+    independent: modes.independent,
+    unavailableReason,
+  };
+}
+
 /** Operator state uses the same durable pending set as the outbox projector. */
 export async function inspectRuntimeEventProjection(
   client: PostgresSchedulerQueryClient,

package/dist/bundling-sources/shared_libs/plays/tool-response-contract.ts

@@ -23,6 +23,31 @@ export type ToolResponseContract =
 
 export type ToolResponseView = 'data' | 'rawV2';
 
+/** Authoring guidance shared by provider descriptions and the public CLI. */
+export const TOOL_RESPONSE_AUTHORING_GUIDANCE = {
+  prefer: [
+    'Use toolExecutionResult.extractedLists.<name>.get() only for declared extracted lists listed below.',
+    'Use toolExecutionResult.extractedValues.<name>.get() only for declared extracted values listed below. Values may be scalars or normalized objects such as EmailStatus; inspect each entry details.strategy and details.valueType.',
+    'Use toolExecutionResult.toolResponse.rawV2 for provider/tool-specific scalar fields, fields in outputSchema that are not declared extracted values, and debugging. Inspect the observed response envelope before selecting nested fields. For declared row/list outputs, use extractedLists.<name>.get().',
+    'toolResponse.rawV2 is the complete parsed and scrubbed provider response, including JSON:API included resources, cursors, links, and totals. It is not the original HTTP bytes or headers.',
+  ],
+  rawMeaning:
+    'Complete parsed and scrubbed provider response for provider/tool-specific scalar fields and debugging. Inspect its envelope before selecting nested fields. Declared row/list outputs should use extractedLists.<name>.get().',
+  invalidGetterHint:
+    'If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; inspect toolResponse.rawV2 for provider/tool-specific scalar fields, and use extractedLists.<name>.get() for declared row/list outputs.',
+  responseShape: {
+    canonicalResponse: 'toolResponse.rawV2',
+    nesting:
+      'rawV2 preserves the provider/tool adapter envelope. The payload may be at rawV2, rawV2.data, or rawV2.data.data; there is no universal unwrap depth. view: "data" does not flatten rawV2. Prefer declared getters; otherwise inspect the retained response from the same execution surface and assert the exact field path before bulk execution.',
+    outputSchema:
+      'outputSchema describes the declared normalized tool output, not an observed rawV2 envelope. Do not derive a rawV2 field path from it.',
+    extractorPaths:
+      'details.rawToolOutputPaths records compatibility extractor provenance, not copyable rawV2 paths. Use the getter expression; do not mechanically replace raw with rawV2.',
+    missingFields:
+      'An absent expected field is an extraction contract mismatch, not proof of a provider miss or invalid email. Keep legitimate no-result responses distinct from unexpected shapes.',
+  },
+} as const;
+
 export function isToolResponseContract(
   value: unknown,
 ): value is ToolResponseContract {

package/dist/cli/{auth-DCN4DA2T.mjs → auth-337SVWQD.mjs}

@@ -9,11 +9,11 @@ import {
   registerAuthCommands,
   reportSetupCompleted,
   resolvePendingAuthClaimForResume
-} from "./chunk-OILZKWKC.mjs";
-import "./chunk-RQKAKIVL.mjs";
-import "./chunk-AXHRD6ME.mjs";
+} from "./chunk-4LRG6AJZ.mjs";
+import "./chunk-XKW6HTWO.mjs";
+import "./chunk-JWUOPLAR.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-YBYPHZ4I.mjs";
+import "./chunk-MTICVDNY.mjs";
 import "./chunk-NXGCO4JB.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";

package/dist/cli/auth-4ME3NANJ.js

@@ -0,0 +1,31 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+var _chunkP2KELOSTjs = require('./chunk-P2KELOST.js');
+require('./chunk-EAIGGEV5.js');
+require('./chunk-HIXYNASX.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-OOQ4IRP4.js');
+require('./chunk-7P5AA3SN.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+
+
+
+
+exports.EXIT_WORKSPACE_MISMATCH = _chunkP2KELOSTjs.EXIT_WORKSPACE_MISMATCH; exports.clearPendingClaim = _chunkP2KELOSTjs.clearPendingClaim; exports.clearSatisfiedPendingClaim = _chunkP2KELOSTjs.clearSatisfiedPendingClaim; exports.handleRegister = _chunkP2KELOSTjs.handleRegister; exports.handleStatus = _chunkP2KELOSTjs.handleStatus; exports.handleWait = _chunkP2KELOSTjs.handleWait; exports.readPendingAuthClaim = _chunkP2KELOSTjs.readPendingAuthClaim; exports.registerAuthCommands = _chunkP2KELOSTjs.registerAuthCommands; exports.reportSetupCompleted = _chunkP2KELOSTjs.reportSetupCompleted; exports.resolvePendingAuthClaimForResume = _chunkP2KELOSTjs.resolvePendingAuthClaimForResume;