@oddington/sdk 0.1.35 → 0.1.37

package/README.md

@@ -79,6 +79,27 @@ declared `review` handler crosses the Inbox publication seam as `review`; Inbox
 retains the canonical `invoice-import` routine identity separately, without
 deploying or executing that handler.
 
+Microsoft Connection configuration has a separate, optional `access` description.
+It preserves supplied strings, including existing `read` and `read-write` labels,
+and does not grant or restrict Microsoft permissions. Management results omit
+this metadata when absent. Setup and safe inspection are documented in the
+[CLI Connections guide](../../apps/cli/README.md#connections).
+
+With `access: { ai: true }`, `os.ai.generateText` returns non-empty `{ text }`.
+`os.ai.generateObject` returns `{ object }` validated against the requested
+`schema`, with its inferred type. An invalid answer throws `RoutineAIError`
+with code `invalid_output`, a clear bounded `detail`, and the original final
+answer as optional `text` for routine-owned recovery. The text is bounded at
+256 KiB and excluded from the error message and ordinary JSON serialization.
+The routine can inspect it explicitly, apply its own recovery rules, report
+an item failure and continue; it must not cast a rejected answer to the promised
+type. OS does not coerce, drop fields, repair or retry automatically.
+
+An AI call failure can be caught and handled without automatically failing the
+Run. Uncaught routine or step exceptions still fail execution, and outstanding
+AI calls drain before completion. The host retains authority, isolation,
+cancellation and byte limits. Local and remote Runs use the same API.
+
 The bounded grammar supports closed objects with required properties, arrays with
 an explicit `maxItems` from 1 to 64, booleans, strings (at most 4096 code points),
 finite numbers and safe integers with optional inclusive bounds, and Files.
@@ -489,6 +510,44 @@ revision and URL facts. Distinct objects and custom provider values remain.
 Helpers need no initialization and perform no I/O, choose no ref, and add no
 changes. File retention and Data validation/publication remain explicit.
 
+Microsoft helpers are also exported at the package root, with the corresponding
+`OutlookSourceLocation` and `SharePointSourceLocation` types:
+
+```ts
+const messageLocation = source.location.outlook({
+  connection: 'outlook/invoices', message: message.id, url: message.webLink,
+  // attachment: attachment.id, // Include for attachment bytes; omit for message MIME.
+});
+const itemLocation = source.location.sharepoint({
+  connection: 'sharepoint/operations', site: siteId, drive: driveId, item: item.id,
+  version: version.id, path: lastKnownPath, url: item.webUrl,
+});
+```
+
+Construct these only after successful provider reads establish the coordinates
+for the retained bytes, and save them alongside `source.location.os(file)` using
+ordinary Data publication. Request `Prefer: IdType="ImmutableId"` consistently
+when obtaining Outlook message and attachment IDs. These IDs are case-sensitive
+and survive folder moves within the same mailbox, but not archive-mailbox moves
+or export/reimport. Subjects, filenames and `internetMessageId` are not substitutes.
+Omit `attachment` for an exact message MIME File; supply it for an attachment File.
+
+For SharePoint, use the saved Graph site ID, the document library's drive ID and
+the file's driveItem ID. Optional `version` is an actual driveItemVersion ID
+established for those bytes, never an eTag or a guessed version. Omit it when no
+such version is established. Names, paths and URLs do not establish identity.
+Optional `path` is last-known context; `url` is the ordinary HTTPS message web
+link or SharePoint webUrl. Never retain temporary download, upload-session or
+copy-monitor URLs, authorization or credentials in Locations.
+
+Outlook merge identity is connection/message/attachment, with whole messages
+distinct from attachments. SharePoint identity is connection/site/drive/item/
+version, with absent versions distinct from present ones. Matching observations
+replace path/link context, including removing omitted context; distinct IDs,
+versions and copies remain separate. Incomplete coordinates gain no inferred
+identity. The retained OS File and hash own exact content; external edits do
+not change an existing Source's bytes. These helpers perform no provider I/O.
+
 Read a named repository through the authenticated host context:
 
 ```ts

package/dist/browser.js

@@ -221,32 +221,45 @@ function jsonData(value, ancestors = /* @__PURE__ */ new Set()) {
     ancestors.delete(value);
   }
 }
-function validateRoutineSchemaValue(schema2, value) {
-  switch (schema2.type) {
-    case "object":
-      if (!record(value) || (schema2.required ?? []).some((key) => !owns(value, key)) || Object.keys(value).some((key) => !owns(schema2.properties, key))) return invalidValue();
-      for (let [key, child] of Object.entries(value)) validateRoutineSchemaValue(schema2.properties[key], child);
-      return;
-    case "array":
-      if (!denseArray(value) || value.length > schema2.maxItems) return invalidValue();
-      for (let child of value) validateRoutineSchemaValue(schema2.items, child);
-      return;
-    case "boolean":
-      return typeof value != "boolean" ? invalidValue() : void 0;
-    case "string":
-      return typeof value != "string" || Array.from(value).length > (schema2.maxLength ?? 4096) ? invalidValue() : void 0;
-    case "integer":
-    case "number":
-      return typeof value != "number" || !(schema2.type === "integer" ? Number.isSafeInteger(value) : Number.isFinite(value)) || schema2.minimum !== void 0 && value < schema2.minimum || schema2.maximum !== void 0 && value > schema2.maximum ? invalidValue() : void 0;
-    case "file":
-      try {
-        jsonData(value);
-        let file2 = parseFileDescriptor(value);
-        if (schema2.path !== void 0 && file2.path !== schema2.path) return invalidValue();
-      } catch {
-        return invalidValue();
+function validateRoutineSchemaValue(schema2, value, rejected) {
+  let type = (value2) => value2 === null ? "null" : Array.isArray(value2) ? "array" : ["object", "boolean", "string", "number"].includes(typeof value2) ? typeof value2 : "other";
+  function check(schema3, value2, path) {
+    let fail4 = (reason, extra = {}) => (rejected?.({ reason, path: path.length <= 256 ? path : "$", expected: schema3.type, received: type(value2), ...extra }), invalidValue());
+    switch (schema3.type) {
+      case "object":
+        if (!record(value2)) return fail4("wrong_type");
+        for (let key of schema3.required ?? []) if (!owns(value2, key)) return fail4("missing_field", {
+          path: `${path}.${key}`.length <= 256 ? `${path}.${key}` : "$",
+          expected: schema3.properties[key].type,
+          received: "missing"
+        });
+        if (Object.keys(value2).some((key) => !owns(schema3.properties, key))) return fail4("unexpected_field");
+        for (let [key, child] of Object.entries(value2)) check(schema3.properties[key], child, `${path}.${key}`);
+        return;
+      case "array":
+        if (!denseArray(value2)) return fail4("wrong_type");
+        if (value2.length > schema3.maxItems) return fail4("out_of_bounds", { constraint: "maxItems", limit: schema3.maxItems });
+        value2.forEach((child, index) => check(schema3.items, child, `${path}[${index}]`));
+        return;
+      case "boolean":
+        return typeof value2 != "boolean" ? fail4("wrong_type") : void 0;
+      case "string":
+        return typeof value2 != "string" ? fail4("wrong_type") : Array.from(value2).length > (schema3.maxLength ?? 4096) ? fail4("out_of_bounds", { constraint: "maxLength", limit: schema3.maxLength ?? 4096 }) : void 0;
+      case "integer":
+      case "number":
+        return typeof value2 != "number" || !(schema3.type === "integer" ? Number.isSafeInteger(value2) : Number.isFinite(value2)) ? fail4("wrong_type") : schema3.minimum !== void 0 && value2 < schema3.minimum ? fail4("out_of_bounds", { constraint: "minimum", limit: schema3.minimum }) : schema3.maximum !== void 0 && value2 > schema3.maximum ? fail4("out_of_bounds", { constraint: "maximum", limit: schema3.maximum }) : void 0;
+      case "file": {
+        let file2;
+        try {
+          jsonData(value2), file2 = parseFileDescriptor(value2);
+        } catch {
+          return fail4("invalid_file");
+        }
+        if (schema3.path !== void 0 && file2.path !== schema3.path) return fail4("invalid_file");
       }
+    }
   }
+  check(schema2, value, "$");
 }
 
 var InboxContractError = class extends Error {
@@ -695,20 +708,82 @@ function parseRoutineAccess(value) {
   }
 }
 
-var ROUTINE_AI_VALUE_BYTES = 256 * 1024, ROUTINE_AI_EVIDENCE_BYTES = 4 * 1024;
+function parseRoutineAIOutputIssue(value) {
+  if (!value || typeof value != "object" || Array.isArray(value)) return;
+  let v = value;
+  if (["invalid_json", "invalid_response", "empty_text"].includes(String(v.reason)))
+    return Object.keys(v).join(",") === "reason" ? { reason: v.reason } : void 0;
+  if (!(!["missing_field", "unexpected_field", "wrong_type", "out_of_bounds", "invalid_file"].includes(String(v.reason)) || typeof v.path != "string" || v.path.length > 256 || !/^\$(?:\.[a-z][A-Za-z0-9]*|\[(?:0|[1-9][0-9]*)\])*$/.test(v.path) || !["object", "array", "boolean", "string", "integer", "number", "file"].includes(String(v.expected)) || !["missing", "null", "object", "array", "boolean", "string", "number", "other"].includes(String(v.received)) || Object.keys(v).some((key) => !["reason", "path", "expected", "received", "constraint", "limit"].includes(key)))) {
+    if (v.reason === "out_of_bounds") {
+      if (!["maxLength", "maxItems", "minimum", "maximum"].includes(String(v.constraint)) || typeof v.limit != "number" || !Number.isFinite(v.limit)) return;
+    } else if (Object.hasOwn(v, "constraint") || Object.hasOwn(v, "limit")) return;
+    return {
+      reason: v.reason,
+      path: v.path,
+      expected: v.expected,
+      received: v.received,
+      ...v.reason === "out_of_bounds" ? { constraint: v.constraint, limit: v.limit } : {}
+    };
+  }
+}
+function routineAIOutputMessage(issue) {
+  if (issue.reason === "invalid_json") return "AI replied, but its answer could not be read as JSON.";
+  if (issue.reason === "invalid_response") return "AI returned a response OS could not read.";
+  if (issue.reason === "empty_text") return "AI returned an empty answer.";
+  let field = issue.path === "$" ? "response" : issue.path.slice(issue.path.startsWith("$.") ? 2 : 1), expected = {
+    object: "an object",
+    array: "a list",
+    boolean: "true or false",
+    string: "text",
+    integer: "a whole number",
+    number: "a number",
+    file: "a File"
+  }[issue.expected], received = {
+    missing: "a missing field",
+    null: "null",
+    object: "an object",
+    array: "a list",
+    boolean: "true or false",
+    string: "text",
+    number: "a number",
+    other: "an unsupported value"
+  }[issue.received];
+  if (issue.reason === "missing_field") return `AI response is missing a required field.
+  ${field}: expected ${expected}; the field was missing.`;
+  if (issue.reason === "unexpected_field") return `AI response includes an unexpected field.
+  ${field}: only the fields declared by the routine are allowed.`;
+  if (issue.reason === "invalid_file") return `AI response contains an invalid File.
+  ${field}: expected a valid File matching the routine's requirements.`;
+  if (issue.reason === "out_of_bounds") {
+    let constraint = {
+      maxLength: `at most ${issue.limit} characters`,
+      maxItems: `at most ${issue.limit} items`,
+      minimum: `a value of at least ${issue.limit}`,
+      maximum: `a value of at most ${issue.limit}`
+    }[issue.constraint];
+    return `AI response is outside a permitted limit.
+  ${field}: expected ${constraint}.`;
+  }
+  return `AI response has the wrong type.
+  ${field}: expected ${expected}; received ${received}.`;
+}
+
+var ROUTINE_AI_VALUE_BYTES = 256 * 1024, ROUTINE_AI_RESULT_BYTES = 6 * ROUTINE_AI_VALUE_BYTES + 1024, ROUTINE_AI_EVIDENCE_BYTES = 4 * 1024;
 var RoutineAIError = class extends Error {
-  constructor(code) {
-    super(code);
+  constructor(code, options = {}) {
+    let detail = code === "invalid_output" ? parseRoutineAIOutputIssue(options.detail) : void 0;
+    super(detail ? routineAIOutputMessage(detail) : code);
     this.code = code;
-    this.name = "RoutineAIError";
+    this.name = "RoutineAIError", detail && (this.detail = Object.freeze(detail)), code === "invalid_output" && typeof options.text == "string" && new TextEncoder().encode(options.text).byteLength <= ROUTINE_AI_VALUE_BYTES && Object.defineProperty(this, "text", { value: options.text });
   }
   code;
+  detail;
 };
-function capture(value, invalid9, oversized) {
+function capture(value, invalid9, oversized, limit = ROUTINE_AI_VALUE_BYTES) {
   try {
     assertRoutineJson(value);
     let encoded = JSON.stringify(value);
-    if (new TextEncoder().encode(encoded).byteLength > ROUTINE_AI_VALUE_BYTES) throw new RoutineAIError(oversized);
+    if (new TextEncoder().encode(encoded).byteLength > limit) throw new RoutineAIError(oversized);
     return freezeRoutineMetadata(JSON.parse(encoded));
   } catch (error) {
     throw error instanceof RoutineAIError ? error : new RoutineAIError(invalid9);
@@ -727,19 +802,47 @@ function parseRoutineAIRequest(value) {
   }
 }
 function parseRoutineAIResult(request2, value) {
-  let v = capture(value, "invalid_output", "output_too_large");
+  let v;
   try {
-    if (request2.kind === "generateText") {
-      if (assertRoutineFields(v, ["text"]), typeof v.text != "string" || !v.text.trim()) throw new Error();
-      return freezeRoutineMetadata({ text: v.text });
-    } else {
-      if (assertRoutineFields(v, ["object"]), !Object.hasOwn(v, "object")) throw new Error();
-      return validateRoutineSchemaValue(request2.schema, v.object), freezeRoutineMetadata({ object: v.object });
+    if (v = capture(
+      value,
+      "invalid_output",
+      "output_too_large",
+      request2.kind === "generateText" ? ROUTINE_AI_RESULT_BYTES : ROUTINE_AI_VALUE_BYTES
+    ), assertRoutineFields(v, request2.kind === "generateText" ? ["text"] : ["object"]), request2.kind === "generateText") {
+      if (typeof v.text != "string") throw new Error();
+      return acceptText(request2, v.text);
     }
+    if (!Object.hasOwn(v, "object")) throw new Error();
+  } catch (error) {
+    throw error instanceof RoutineAIError ? error : new RoutineAIError("invalid_output", { detail: { reason: "invalid_response" } });
+  }
+  return validateObject(request2.schema, v.object), freezeRoutineMetadata({ object: v.object });
+}
+function validateObject(schema2, object5, text5) {
+  let detail = { reason: "invalid_response" };
+  try {
+    validateRoutineSchemaValue(schema2, object5, (issue) => {
+      detail = issue;
+    });
   } catch {
-    throw new RoutineAIError("invalid_output");
+    throw new RoutineAIError("invalid_output", { ...text5 === void 0 ? {} : { text: text5 }, detail });
   }
 }
+function acceptText(request2, text5) {
+  if (new TextEncoder().encode(text5).byteLength > ROUTINE_AI_VALUE_BYTES) throw new RoutineAIError("output_too_large");
+  if (request2.kind === "generateText") {
+    if (!text5.trim()) throw new RoutineAIError("invalid_output", { text: text5, detail: { reason: "empty_text" } });
+    return freezeRoutineMetadata({ text: text5 });
+  }
+  let object5;
+  try {
+    object5 = JSON.parse(text5);
+  } catch {
+    throw new RoutineAIError("invalid_output", { text: text5, detail: { reason: "invalid_json" } });
+  }
+  return validateObject(request2.schema, object5, text5), capture({ object: object5 }, "invalid_output", "output_too_large");
+}
 
 var LIMIT = 256 * 1024, invalid3 = () => {
   throw new AppRoutineContractError("invalid_value");
@@ -865,7 +968,7 @@ function captureRoutineInput(definition, input) {
   return capture2(contract.input, input === void 0 && Object.hasOwn(contract, "inputDefault") ? contract.inputDefault : input);
 }
 async function executeRoutineDefinition(definition, input, runtime) {
-  let captured = captureRoutineInput(definition, input), { contract, steps, run } = definitions.get(definition), active2 = !0, accepting = !0, broken = !1, work = Promise.resolve(), aiFailure, aiWork = /* @__PURE__ */ new Set(), generate = (kind, value) => {
+  let captured = captureRoutineInput(definition, input), { contract, steps, run } = definitions.get(definition), active2 = !0, accepting = !0, broken = !1, work = Promise.resolve(), aiWork = /* @__PURE__ */ new Set(), generate = (kind, value) => {
     let operation2 = (async () => {
       if (!active2 || broken || contract.access.ai !== !0) throw new RoutineAIError("access_denied");
       if (!runtime.ai) throw new RoutineAIError("capability_unavailable");
@@ -884,9 +987,7 @@ async function executeRoutineDefinition(definition, input, runtime) {
       if (!active2 || broken) throw new RoutineAIError("access_denied");
       return parseRoutineAIResult(request2, result3);
     })();
-    return aiWork.add(operation2), operation2.then(() => aiWork.delete(operation2), (error) => {
-      aiFailure ??= error, broken = !0, aiWork.delete(operation2);
-    }), operation2;
+    return aiWork.add(operation2), operation2.then(() => aiWork.delete(operation2), () => aiWork.delete(operation2)), operation2;
   }, called = /* @__PURE__ */ new Set(), reached = /* @__PURE__ */ new Set(), guarded = (value, receiver) => typeof value == "function" ? (...args) => {
     if (!active2 || broken) throw new Error("Run authority ended");
     return guarded(Reflect.apply(value, receiver, args));
@@ -950,7 +1051,7 @@ async function executeRoutineDefinition(definition, input, runtime) {
   for (accepting = !1, await work; aiWork.size; ) await Promise.allSettled([...aiWork]);
   active2 = !1;
   for (let step of contract.steps) reached.has(step.id) || await runtime.step(step.id, { status: "skipped" });
-  if (broken) throw failure ?? aiFailure ?? new AppRoutineContractError("invalid_value");
+  if (broken) throw failure ?? new AppRoutineContractError("invalid_value");
   if (contract.result !== void 0) return capture2(contract.result, result2);
   if (result2 !== void 0) return invalid3();
 }
@@ -1859,6 +1960,37 @@ var files = {
 function validDropboxRootPath(value) {
   return typeof value == "string" && value.length <= 2048 && value.startsWith("/") && !/[\\\x00-\x1f\x7f]/.test(value) && value.slice(1).split("/").every((segment) => segment.length > 0 && segment.trim() === segment && segment !== "." && segment !== "..");
 }
+function validMicrosoftId(value) {
+  return typeof value == "string" && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(value);
+}
+function validMicrosoftMailbox(value) {
+  return typeof value == "string" && value.length <= 254 && /^[^\s@/?#\\\x00-\x1f\x7f]+@[^\s@/?#\\\x00-\x1f\x7f]+\.[^\s@/?#\\\x00-\x1f\x7f]+$/.test(value);
+}
+function sharePointHost(value) {
+  return /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.sharepoint\.com$/.test(value);
+}
+function canonicalSharePointSiteUrl(value) {
+  if (!(typeof value != "string" || value.length > 2048 || /[\s\\?#\x00-\x1f\x7f]/.test(value) || !/^https:\/\/[^/:@]+(?:\/|$)/i.test(value)))
+    try {
+      let url = new URL(value);
+      if (url.protocol !== "https:" || !sharePointHost(url.hostname) || url.username || url.password || url.port) return;
+      let rawPath = value.replace(/^https:\/\/[^/]+/i, "") || "/", path = rawPath.endsWith("/") ? rawPath.slice(0, -1) : rawPath, segments = path.slice(1).split("/");
+      if (path && segments.some((segment) => !segment)) return;
+      let encoded = path ? segments.map((segment) => {
+        let decoded = decodeURIComponent(segment);
+        if (decoded === "." || decoded === ".." || /[/%\\?#\x00-\x1f\x7f]/.test(decoded)) throw new Error();
+        return encodeURIComponent(decoded);
+      }).join("/") : "", canonical = `https://${url.hostname}/${encoded}`;
+      return canonical.length <= 2048 ? canonical : void 0;
+    } catch {
+      return;
+    }
+}
+function validSharePointSiteId(value, siteUrl) {
+  if (typeof value != "string" || value.length > 512) return !1;
+  let [host, collection, site, extra] = value.split(",");
+  return extra === void 0 && host === new URL(siteUrl).hostname && validMicrosoftId(collection) && validMicrosoftId(site);
+}
 function validGoogleScopes(value) {
   return Array.isArray(value) && value.length > 0 && value.length <= 32 && value.every((scope) => typeof scope == "string" && scope.length <= 256 && /^(https:\/\/www\.googleapis\.com\/auth\/[A-Za-z0-9._-]+|https:\/\/mail\.google\.com\/|openid|email|profile)$/.test(scope)) && new Set(value).size === value.length;
 }
@@ -1869,13 +2001,32 @@ function validDropboxFileScopes(value) {
 
 var ROUTINE_CONNECTION_CREDENTIALS_ENV = "OS_ROUTINE_CONNECTION_CREDENTIALS";
 function parseRoutineConnectionNames(value) {
-  if (!Array.isArray(value) || value.some((name2) => typeof name2 != "string" || !/^(gmail|airtable|dropbox)\/[a-z0-9][a-z0-9-]{0,62}$/.test(name2)) || new Set(value).size !== value.length)
+  if (!Array.isArray(value) || value.some((name2) => typeof name2 != "string" || !/^(gmail|airtable|dropbox|outlook|sharepoint)\/[a-z0-9][a-z0-9-]{0,62}$/.test(name2)) || new Set(value).size !== value.length)
     throw new Error("Invalid routine connections");
   return value;
 }
 var connectionUuid = (v) => typeof v == "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(v);
 function runtimeConnection(lease) {
   switch (lease.provider) {
+    case "outlook":
+      return {
+        id: `outlook/${lease.name}`,
+        provider: lease.provider,
+        name: lease.name,
+        mailboxEmail: lease.mailboxEmail,
+        accessToken: lease.accessToken,
+        expiresAt: lease.expiresAt
+      };
+    case "sharepoint":
+      return {
+        id: `sharepoint/${lease.name}`,
+        provider: lease.provider,
+        name: lease.name,
+        siteId: lease.siteId,
+        siteUrl: lease.siteUrl,
+        accessToken: lease.accessToken,
+        expiresAt: lease.expiresAt
+      };
     case "gmail":
       return {
         id: `gmail/${lease.name}`,
@@ -1913,6 +2064,11 @@ function parseConnectionLease(raw, now = Date.now()) {
   let v = raw;
   if (!v || typeof v != "object" || Array.isArray(v) || !connectionUuid(v.connectionId) || !connectionUuid(v.runId) || typeof v.name != "string" || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(v.name) || typeof v.accessToken != "string" || !/^[A-Za-z0-9._~+/-]{1,8192}={0,2}$/.test(v.accessToken))
     throw new Error("Invalid connection credential");
+  if (v.provider === "outlook" || v.provider === "sharepoint") {
+    if (!(v.provider === "outlook" ? Object.keys(v).sort().join(",") === "accessToken,connectionId,expiresAt,mailboxEmail,name,provider,runId" && validMicrosoftMailbox(v.mailboxEmail) : Object.keys(v).sort().join(",") === "accessToken,connectionId,expiresAt,name,provider,runId,siteId,siteUrl" && typeof v.siteUrl == "string" && canonicalSharePointSiteUrl(v.siteUrl) === v.siteUrl && validSharePointSiteId(v.siteId, v.siteUrl)) || typeof v.expiresAt != "string" || !Number.isFinite(Date.parse(v.expiresAt)) || Date.parse(v.expiresAt) <= now + 6e4 || Date.parse(v.expiresAt) > now + 36e5)
+      throw new Error("Invalid connection credential");
+    return v;
+  }
   if (v.provider === "gmail") {
     if (Object.keys(v).sort().join(",") !== "accessToken,accountEmail,connectionId,expiresAt,name,provider,runId,scopes" || typeof v.accountEmail != "string" || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v.accountEmail) || !validGoogleScopes(v.scopes) || typeof v.expiresAt != "string" || !Number.isFinite(Date.parse(v.expiresAt)) || Date.parse(v.expiresAt) <= now + 6e4 || Date.parse(v.expiresAt) > now + 36e5)
       throw new Error("Invalid connection credential");
@@ -2180,7 +2336,17 @@ var connections = /* @__PURE__ */ runtimeConnections();
 var LOCAL_ROUTINE_VALUE_BYTES = 256 * 1024;
 
 function locationIdentity(location) {
-  let coordinates = location.provider === "os" ? [location.file] : location.provider === "gmail" ? [location.connection, location.message, location.attachment] : location.provider === "dropbox" ? [location.connection, location.file] : void 0;
+  let coordinates = location.provider === "os" ? [location.file] : location.provider === "gmail" ? [location.connection, location.message, location.attachment] : location.provider === "dropbox" ? [location.connection, location.file] : location.provider === "outlook" ? [
+    location.connection,
+    location.message,
+    ...location.attachment === void 0 ? [] : [location.attachment]
+  ] : location.provider === "sharepoint" ? [
+    location.connection,
+    location.site,
+    location.drive,
+    location.item,
+    ...location.version === void 0 ? [] : [location.version]
+  ] : void 0;
   if (coordinates?.every((value) => typeof value == "string" && value.length > 0))
     return JSON.stringify([location.provider, ...coordinates]);
 }
@@ -2219,6 +2385,27 @@ var source = {
         ...input.path === void 0 ? {} : { path: input.path },
         ...input.url === void 0 ? {} : { url: input.url }
       };
+    },
+    outlook(input) {
+      return {
+        provider: "outlook",
+        connection: input.connection,
+        message: input.message,
+        ...input.attachment === void 0 ? {} : { attachment: input.attachment },
+        ...input.url === void 0 ? {} : { url: input.url }
+      };
+    },
+    sharepoint(input) {
+      return {
+        provider: "sharepoint",
+        connection: input.connection,
+        site: input.site,
+        drive: input.drive,
+        item: input.item,
+        ...input.version === void 0 ? {} : { version: input.version },
+        ...input.path === void 0 ? {} : { path: input.path },
+        ...input.url === void 0 ? {} : { url: input.url }
+      };
     }
   },
   locations: {
@@ -4016,6 +4203,7 @@ export {
   FileOperationError,
   InboxContractError,
   InboxOperationError,
+  RoutineAIError,
   app,
   asksBlock,
   auth,