@cuylabs/physical-agent-core 0.1.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,86 @@
+# @cuylabs/physical-agent-core
+
+Agent-core tools for physical AI sessions.
+
+This package binds `@cuylabs/physical-core` sessions to `@cuylabs/agent-core`
+tools. It contains generic status, observe, artifact, stop, and policy-code
+tool factories.
+
+The package does not define physical session contracts and does not connect to
+any robotics backend. It turns an existing `PhysicalSession` into a small,
+model-facing `agent-core` tool surface.
+
+## Install
+
+```bash
+npm install @cuylabs/agent-core @cuylabs/physical-core @cuylabs/physical-agent-core
+```
+
+## Use
+
+```typescript
+import { createAgent } from "@cuylabs/agent-core";
+import { createPhysicalSessionTools } from "@cuylabs/physical-agent-core";
+
+const agent = createAgent({
+  model,
+  tools: createPhysicalSessionTools(session),
+  systemPrompt:
+    "You are controlling a physical session. Observe before acting.",
+});
+```
+
+For sessions that support direct code execution, the generated toolset includes
+`physical_run_policy_code`. For sessions that only expose observation/status or
+external trial control, that tool is omitted.
+
+Backend adapters can add extra tools next to the generic set. For example, a
+CaP-X adapter may expose turn history while still using the same generic
+status, observe, artifact, stop, and policy-code contracts. Backend-specific
+helper libraries should normally appear as observation/context for generated
+policy code, not as extra model-facing robot tools.
+
+## Generated Tools
+
+`createPhysicalSessionTools(session)` can produce:
+
+- `physical_status`
+- `physical_observe`
+- `physical_artifacts`
+- `physical_stop`
+- `physical_run_policy_code` when `session.executeCode` exists
+
+Use the `prefix` option when composing backend-specific surfaces:
+
+```typescript
+const tools = createPhysicalSessionTools(session, { prefix: "capx" });
+```
+
+## Boundary
+
+Use this package only when the host runtime is `@cuylabs/agent-core`. The
+physical session contracts remain in `@cuylabs/physical-core`.
+
+This package should not contain backend-specific launchers, service clients,
+simulator mappings, or robot APIs. Those belong in backend packages such as
+`@cuylabs/physical-capx`.
+
+## Design Notes
+
+- A physical capability is not just a normal tool. It may depend on calibrated
+  sensors, timing, world state, hardware readiness, and explicit safety policy.
+- Physical tool outputs include structured metadata so UIs and middleware can
+  inspect observations, traces, artifacts, and outcomes.
+- Direct physical execution is marked dangerous by default and uses manual
+  replay semantics because repeated execution can move hardware or mutate a
+  simulator.
+
+## Docs
+
+- [docs/README.md](./docs/README.md) for the documentation map
+- [../physical-core/docs/safety.md](../physical-core/docs/safety.md) for the
+  core safety model
+
+## License
+
+Apache-2.0

package/dist/chunk-6VUPCNET.js

@@ -0,0 +1,502 @@
+// src/tools/index.ts
+import { Tool } from "@cuylabs/agent-core/tool";
+import { z } from "zod";
+import {
+  describePhysicalState,
+  normalizePhysicalSafetyPolicy
+} from "@cuylabs/physical-core";
+function toolName(name, options) {
+  return `${options?.prefix ?? "physical"}_${name}`;
+}
+var MAX_OBSERVATION_ITEM_CHARS = 12e3;
+var MAX_OBSERVATION_OUTPUT_CHARS = 6e4;
+var MAX_EXECUTION_OUTPUT_CHARS = 8e3;
+function truncateText(value, maxChars) {
+  if (value.length <= maxChars) {
+    return value;
+  }
+  return `${value.slice(0, maxChars)}
+... (${value.length - maxChars} characters omitted from this observation item)`;
+}
+function stringifyObservationData(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  try {
+    return JSON.stringify(value, null, 2) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function compactRawDepthDiagnostics(value) {
+  const rawDepth = asRecord(value);
+  if (!rawDepth) {
+    return void 0;
+  }
+  const compact = {};
+  for (const [camera, statsValue] of Object.entries(rawDepth)) {
+    const stats = asRecord(statsValue);
+    if (!stats) {
+      compact[camera] = statsValue;
+      continue;
+    }
+    compact[camera] = {
+      shape: stats.shape,
+      dtype: stats.dtype,
+      min: stats.min,
+      max: stats.max,
+      finiteMin: stats.finiteMin,
+      finiteMax: stats.finiteMax,
+      nanCount: stats.nanCount,
+      infCount: stats.infCount,
+      belowZeroCount: stats.belowZeroCount,
+      aboveOneCount: stats.aboveOneCount,
+      outOfRangeCount: stats.outOfRangeCount,
+      error: stats.error
+    };
+  }
+  return Object.keys(compact).length > 0 ? compact : void 0;
+}
+function formatExecutionOutput(trace) {
+  const outcome = trace.outcome;
+  const sandboxRc = outcome?.metadata?.sandboxRc;
+  const elapsedMs = outcome?.metadata?.elapsedMs;
+  const codePath = outcome?.metadata?.codePath;
+  const diagnostics = outcome?.metadata?.diagnostics;
+  const lines = [
+    outcome ? `executionOk=${outcome.success}, taskCompleted=${outcome.taskCompleted ?? "n/a"}, reward=${outcome.reward ?? "n/a"}` : "Execution completed without an outcome."
+  ];
+  if (sandboxRc !== void 0) {
+    lines.push(`sandboxRc=${sandboxRc}`);
+  }
+  if (elapsedMs !== void 0) {
+    lines.push(`elapsedMs=${elapsedMs}`);
+  }
+  if (codePath !== void 0) {
+    lines.push(`codePath=${codePath}`);
+  }
+  if (diagnostics && typeof diagnostics === "object") {
+    lines.push(
+      `diagnostics:
+${truncateText(
+        stringifyObservationData({
+          failurePhase: diagnostics.failurePhase,
+          exceptionType: diagnostics.exceptionType,
+          exceptionRepr: diagnostics.exceptionRepr,
+          observationPipeline: diagnostics.observationPipeline,
+          depthAssertion: diagnostics.depthAssertion,
+          perceptionApiFailure: diagnostics.perceptionApiFailure,
+          emptyPointCloud: diagnostics.emptyPointCloud,
+          trial: diagnostics.trial,
+          envClass: diagnostics.envClass,
+          lowLevelEnvClass: diagnostics.lowLevelEnvClass,
+          renderCameraNames: diagnostics.render_camera_names,
+          simStepCount: diagnostics._sim_step_count,
+          rawDepth: compactRawDepthDiagnostics(diagnostics.rawDepth),
+          sourceFiles: diagnostics.sourceFiles
+        }),
+        MAX_EXECUTION_OUTPUT_CHARS
+      )}`
+    );
+  }
+  if (outcome?.terminated !== void 0 || outcome?.truncated !== void 0) {
+    lines.push(
+      `terminated=${outcome.terminated ?? "n/a"}, truncated=${outcome.truncated ?? "n/a"}`
+    );
+  }
+  if (trace.stdout) {
+    lines.push(
+      `stdout:
+${truncateText(trace.stdout, MAX_EXECUTION_OUTPUT_CHARS)}`
+    );
+  }
+  if (trace.stderr) {
+    lines.push(
+      `stderr:
+${truncateText(trace.stderr, MAX_EXECUTION_OUTPUT_CHARS)}`
+    );
+  }
+  if (trace.artifacts?.length) {
+    lines.push(
+      `artifacts:
+${trace.artifacts.map((artifact) => `${artifact.kind}: ${artifact.uri}`).join("\n")}`
+    );
+  }
+  return lines.join("\n\n");
+}
+function formatImageObservation(item) {
+  if (item.kind !== "rgb" && item.kind !== "depth") {
+    return "";
+  }
+  const details = [
+    item.width && item.height ? `size=${item.width}x${item.height}` : null,
+    item.mimeType ? `mime=${item.mimeType}` : null,
+    item.frame ? `frame=${item.frame}` : null,
+    item.uri ? `uri=${item.uri}` : null,
+    item.dataUrl ? "dataUrl=available in tool metadata" : null
+  ].filter(Boolean);
+  return details.length > 0 ? details.join(", ") : "image captured";
+}
+function formatObservationItem(item, index) {
+  const header = `## Observation ${index + 1}: ${item.source} (${item.kind})`;
+  if (item.kind === "text") {
+    return `${header}
+${truncateText(item.text, MAX_OBSERVATION_ITEM_CHARS)}`;
+  }
+  if (item.kind === "rgb" || item.kind === "depth") {
+    return `${header}
+${formatImageObservation(item)}`;
+  }
+  if (!("data" in item)) {
+    return `${header}
+No structured payload was provided.`;
+  }
+  return `${header}
+${truncateText(
+    stringifyObservationData(item.data),
+    MAX_OBSERVATION_ITEM_CHARS
+  )}`;
+}
+function formatObservationOutput(observation) {
+  const summary = observation.summary ?? `${observation.items.length} observation item(s) captured.`;
+  if (observation.items.length === 0) {
+    return summary;
+  }
+  const sections = [
+    summary,
+    ...observation.items.map(
+      (item, index) => formatObservationItem(item, index)
+    )
+  ];
+  const output = sections.join("\n\n");
+  return truncateText(output, MAX_OBSERVATION_OUTPUT_CHARS);
+}
+function parseImageData(item) {
+  if (item.kind !== "rgb" && item.kind !== "depth") {
+    return void 0;
+  }
+  if (!item.dataUrl) {
+    return void 0;
+  }
+  const match = item.dataUrl.match(/^data:([^;,]+)(?:;[^,]*)?,(.*)$/s);
+  if (!match) {
+    return void 0;
+  }
+  return {
+    mediaType: item.mimeType ?? match[1] ?? "image/png",
+    data: match[2] ?? ""
+  };
+}
+function createObservationModelOutput(observation, output) {
+  const parts = [{ type: "text", text: output }];
+  for (const item of observation.items) {
+    const image = parseImageData(item);
+    if (!image) {
+      continue;
+    }
+    parts.push({
+      type: "file-data",
+      data: image.data,
+      mediaType: image.mediaType
+    });
+  }
+  return parts.length > 1 ? {
+    type: "content",
+    value: parts
+  } : {
+    type: "text",
+    value: output
+  };
+}
+function createPhysicalStatusTool(session, options) {
+  return Tool.define(
+    toolName("status", options),
+    {
+      description: "Read the current physical session state and lifecycle status without moving or changing the environment.",
+      parameters: z.object({}),
+      capabilities: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      },
+      execute: async () => {
+        const state = await session.getState();
+        return {
+          title: "Physical Session Status",
+          output: describePhysicalState(state),
+          metadata: {
+            physical: {
+              sessionId: session.id,
+              status: state.status,
+              state
+            }
+          }
+        };
+      }
+    },
+    {
+      capabilitiesHint: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      }
+    }
+  );
+}
+function createPhysicalObserveTool(session, options) {
+  return Tool.define(
+    toolName("observe", options),
+    {
+      description: "Capture the latest physical-world observation and session context for the active robot or simulator without moving or changing the environment.",
+      parameters: z.object({
+        includeImages: z.boolean().optional().describe(
+          "Whether image observations should be included when available."
+        ),
+        includeArtifacts: z.boolean().optional().describe(
+          "Whether artifact references should be included when available."
+        ),
+        maxItems: z.number().int().positive().optional().describe("Maximum number of observation items to return.")
+      }),
+      capabilities: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      },
+      execute: async (params) => {
+        if (!session.observe) {
+          return {
+            title: "Observation Unsupported",
+            output: "This physical session does not expose observations.",
+            metadata: {
+              physical: {
+                sessionId: session.id
+              }
+            }
+          };
+        }
+        const observeOptions = {
+          includeImages: params.includeImages,
+          includeArtifacts: params.includeArtifacts,
+          maxItems: params.maxItems
+        };
+        const observation = await session.observe(observeOptions);
+        const output = formatObservationOutput(observation);
+        return {
+          title: "Physical Observation",
+          output,
+          metadata: {
+            modelOutput: createObservationModelOutput(observation, output),
+            physical: {
+              sessionId: session.id,
+              status: observation.status,
+              observation
+            }
+          }
+        };
+      }
+    },
+    {
+      capabilitiesHint: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      }
+    }
+  );
+}
+function createPhysicalRunCodeTool(session, options) {
+  return Tool.define(
+    toolName("run_policy_code", options),
+    {
+      description: "Execute policy code inside the active physical session after observing the current context. This can move a robot or mutate a simulator.",
+      parameters: z.object({
+        code: z.string().min(1).describe("Executable policy code."),
+        language: z.string().optional().describe("Code language. Defaults to the session runtime language."),
+        timeoutMs: z.number().int().positive().optional().describe("Optional execution timeout in milliseconds."),
+        dryRun: z.boolean().optional().describe(
+          "Validate or stage the code without executing if supported."
+        )
+      }),
+      capabilities: {
+        parallelSafe: false,
+        readOnly: false,
+        destructive: true,
+        riskLevel: "dangerous",
+        onInterrupt: "cancel"
+      },
+      replayPolicy: {
+        mode: "manual",
+        sideEffectLevel: "external",
+        reason: "Physical code execution may move hardware or mutate simulator state and must not be replayed automatically."
+      },
+      execute: async (params) => {
+        if (!session.executeCode) {
+          return {
+            title: "Policy Execution Unsupported",
+            output: "This physical session does not expose direct policy-code execution.",
+            metadata: {
+              physical: {
+                sessionId: session.id
+              }
+            }
+          };
+        }
+        const policy = normalizePhysicalSafetyPolicy({
+          riskLevel: "dangerous",
+          requiresApproval: true,
+          requiresHumanPresence: true
+        });
+        const trace = await session.executeCode({
+          code: params.code,
+          language: params.language,
+          timeoutMs: params.timeoutMs,
+          dryRun: params.dryRun,
+          metadata: { safety: policy }
+        });
+        return {
+          title: "Physical Policy Execution",
+          output: formatExecutionOutput(trace),
+          metadata: {
+            physical: {
+              sessionId: session.id,
+              trace
+            }
+          }
+        };
+      }
+    },
+    {
+      capabilitiesHint: {
+        parallelSafe: false,
+        readOnly: false,
+        destructive: true,
+        riskLevel: "dangerous",
+        onInterrupt: "cancel"
+      }
+    }
+  );
+}
+function createPhysicalStopTool(session, options) {
+  return Tool.define(
+    toolName("stop", options),
+    {
+      description: "Stop the active physical session as quickly as the backend supports. Use only when requested or when continuing would be unsafe.",
+      parameters: z.object({
+        reason: z.string().optional().describe("Reason for stopping the session.")
+      }),
+      capabilities: {
+        parallelSafe: false,
+        readOnly: false,
+        destructive: true,
+        riskLevel: "dangerous",
+        onInterrupt: "cancel"
+      },
+      replayPolicy: {
+        mode: "manual",
+        sideEffectLevel: "external",
+        reason: "Stopping a physical session is a control-plane side effect and should not be replayed automatically."
+      },
+      execute: async ({ reason }) => {
+        const state = await session.stop(reason);
+        return {
+          title: "Physical Session Stopped",
+          output: describePhysicalState(state),
+          metadata: {
+            physical: {
+              sessionId: session.id,
+              status: state.status,
+              state
+            }
+          }
+        };
+      }
+    },
+    {
+      capabilitiesHint: {
+        parallelSafe: false,
+        readOnly: false,
+        destructive: true,
+        riskLevel: "dangerous",
+        onInterrupt: "cancel"
+      }
+    }
+  );
+}
+function createPhysicalArtifactsTool(session, options) {
+  return Tool.define(
+    toolName("artifacts", options),
+    {
+      description: "List artifacts produced by the active physical session, such as logs, generated code, images, videos, or result directories.",
+      parameters: z.object({
+        kind: z.enum(["code", "log", "image", "video", "json", "directory", "other"]).optional().describe("Optional artifact kind filter."),
+        limit: z.number().int().positive().optional().describe("Maximum number of artifacts to return.")
+      }),
+      capabilities: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      },
+      execute: async (params) => {
+        if (!session.listArtifacts) {
+          return {
+            title: "Artifacts Unsupported",
+            output: "This physical session does not expose artifacts.",
+            metadata: {
+              physical: {
+                sessionId: session.id
+              }
+            }
+          };
+        }
+        const listOptions = {
+          kind: params.kind,
+          limit: params.limit
+        };
+        const artifacts = await session.listArtifacts(listOptions);
+        const output = artifacts.length === 0 ? "No physical-session artifacts found." : artifacts.map((artifact) => `${artifact.kind}: ${artifact.uri}`).join("\n");
+        return {
+          title: "Physical Artifacts",
+          output,
+          metadata: {
+            physical: {
+              sessionId: session.id,
+              artifacts
+            }
+          }
+        };
+      }
+    },
+    {
+      capabilitiesHint: {
+        parallelSafe: true,
+        readOnly: true,
+        riskLevel: "safe"
+      }
+    }
+  );
+}
+function createPhysicalSessionTools(session, options) {
+  const tools = [
+    createPhysicalStatusTool(session, options),
+    createPhysicalObserveTool(session, options),
+    createPhysicalArtifactsTool(session, options),
+    createPhysicalStopTool(session, options)
+  ];
+  if (session.executeCode) {
+    tools.splice(2, 0, createPhysicalRunCodeTool(session, options));
+  }
+  return tools;
+}
+
+export {
+  createPhysicalStatusTool,
+  createPhysicalObserveTool,
+  createPhysicalRunCodeTool,
+  createPhysicalStopTool,
+  createPhysicalArtifactsTool,
+  createPhysicalSessionTools
+};
+//# sourceMappingURL=chunk-6VUPCNET.js.map

package/dist/chunk-6VUPCNET.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/index.ts"],"sourcesContent":["import { Tool } from \"@cuylabs/agent-core/tool\";\nimport type { ToolModelOutput } from \"@cuylabs/agent-core/tool\";\nimport { z } from \"zod\";\nimport {\n  describePhysicalState,\n  normalizePhysicalSafetyPolicy,\n} from \"@cuylabs/physical-core\";\nimport type {\n  PhysicalExecutionTrace,\n  PhysicalListArtifactsOptions,\n  PhysicalObserveOptions,\n  PhysicalObservation,\n  PhysicalObservationItem,\n  PhysicalSession,\n  PhysicalToolMetadata,\n} from \"@cuylabs/physical-core\";\n\nexport type PhysicalTool = Tool.Info;\n\ntype ToolModelContentPart = Extract<\n  ToolModelOutput,\n  { type: \"content\" }\n>[\"value\"][number];\n\nexport interface PhysicalToolOptions {\n  /**\n   * Prefix used for generated tool ids. Defaults to \"physical\".\n   */\n  prefix?: string;\n}\n\nfunction toolName(name: string, options?: PhysicalToolOptions): string {\n  return `${options?.prefix ?? \"physical\"}_${name}`;\n}\n\nconst MAX_OBSERVATION_ITEM_CHARS = 12_000;\nconst MAX_OBSERVATION_OUTPUT_CHARS = 60_000;\nconst MAX_EXECUTION_OUTPUT_CHARS = 8_000;\n\nfunction truncateText(value: string, maxChars: number): string {\n  if (value.length <= maxChars) {\n    return value;\n  }\n\n  return `${value.slice(0, maxChars)}\\n... (${value.length - maxChars} characters omitted from this observation item)`;\n}\n\nfunction stringifyObservationData(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  try {\n    return JSON.stringify(value, null, 2) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction compactRawDepthDiagnostics(\n  value: unknown,\n): Record<string, unknown> | undefined {\n  const rawDepth = asRecord(value);\n  if (!rawDepth) {\n    return undefined;\n  }\n\n  const compact: Record<string, unknown> = {};\n  for (const [camera, statsValue] of Object.entries(rawDepth)) {\n    const stats = asRecord(statsValue);\n    if (!stats) {\n      compact[camera] = statsValue;\n      continue;\n    }\n\n    compact[camera] = {\n      shape: stats.shape,\n      dtype: stats.dtype,\n      min: stats.min,\n      max: stats.max,\n      finiteMin: stats.finiteMin,\n      finiteMax: stats.finiteMax,\n      nanCount: stats.nanCount,\n      infCount: stats.infCount,\n      belowZeroCount: stats.belowZeroCount,\n      aboveOneCount: stats.aboveOneCount,\n      outOfRangeCount: stats.outOfRangeCount,\n      error: stats.error,\n    };\n  }\n\n  return Object.keys(compact).length > 0 ? compact : undefined;\n}\n\nfunction formatExecutionOutput(trace: PhysicalExecutionTrace): string {\n  const outcome = trace.outcome;\n  const sandboxRc = outcome?.metadata?.sandboxRc;\n  const elapsedMs = outcome?.metadata?.elapsedMs;\n  const codePath = outcome?.metadata?.codePath;\n  const diagnostics = outcome?.metadata?.diagnostics as\n    | Record<string, unknown>\n    | undefined;\n  const lines = [\n    outcome\n      ? `executionOk=${outcome.success}, taskCompleted=${outcome.taskCompleted ?? \"n/a\"}, reward=${outcome.reward ?? \"n/a\"}`\n      : \"Execution completed without an outcome.\",\n  ];\n\n  if (sandboxRc !== undefined) {\n    lines.push(`sandboxRc=${sandboxRc}`);\n  }\n  if (elapsedMs !== undefined) {\n    lines.push(`elapsedMs=${elapsedMs}`);\n  }\n  if (codePath !== undefined) {\n    lines.push(`codePath=${codePath}`);\n  }\n  if (diagnostics && typeof diagnostics === \"object\") {\n    lines.push(\n      `diagnostics:\\n${truncateText(\n        stringifyObservationData({\n          failurePhase: diagnostics.failurePhase,\n          exceptionType: diagnostics.exceptionType,\n          exceptionRepr: diagnostics.exceptionRepr,\n          observationPipeline: diagnostics.observationPipeline,\n          depthAssertion: diagnostics.depthAssertion,\n          perceptionApiFailure: diagnostics.perceptionApiFailure,\n          emptyPointCloud: diagnostics.emptyPointCloud,\n          trial: diagnostics.trial,\n          envClass: diagnostics.envClass,\n          lowLevelEnvClass: diagnostics.lowLevelEnvClass,\n          renderCameraNames: diagnostics.render_camera_names,\n          simStepCount: diagnostics._sim_step_count,\n          rawDepth: compactRawDepthDiagnostics(diagnostics.rawDepth),\n          sourceFiles: diagnostics.sourceFiles,\n        }),\n        MAX_EXECUTION_OUTPUT_CHARS,\n      )}`,\n    );\n  }\n  if (outcome?.terminated !== undefined || outcome?.truncated !== undefined) {\n    lines.push(\n      `terminated=${outcome.terminated ?? \"n/a\"}, truncated=${outcome.truncated ?? \"n/a\"}`,\n    );\n  }\n  if (trace.stdout) {\n    lines.push(\n      `stdout:\\n${truncateText(trace.stdout, MAX_EXECUTION_OUTPUT_CHARS)}`,\n    );\n  }\n  if (trace.stderr) {\n    lines.push(\n      `stderr:\\n${truncateText(trace.stderr, MAX_EXECUTION_OUTPUT_CHARS)}`,\n    );\n  }\n  if (trace.artifacts?.length) {\n    lines.push(\n      `artifacts:\\n${trace.artifacts\n        .map((artifact) => `${artifact.kind}: ${artifact.uri}`)\n        .join(\"\\n\")}`,\n    );\n  }\n\n  return lines.join(\"\\n\\n\");\n}\n\nfunction formatImageObservation(item: PhysicalObservationItem): string {\n  if (item.kind !== \"rgb\" && item.kind !== \"depth\") {\n    return \"\";\n  }\n\n  const details = [\n    item.width && item.height ? `size=${item.width}x${item.height}` : null,\n    item.mimeType ? `mime=${item.mimeType}` : null,\n    item.frame ? `frame=${item.frame}` : null,\n    item.uri ? `uri=${item.uri}` : null,\n    item.dataUrl ? \"dataUrl=available in tool metadata\" : null,\n  ].filter(Boolean);\n\n  return details.length > 0 ? details.join(\", \") : \"image captured\";\n}\n\nfunction formatObservationItem(\n  item: PhysicalObservationItem,\n  index: number,\n): string {\n  const header = `## Observation ${index + 1}: ${item.source} (${item.kind})`;\n\n  if (item.kind === \"text\") {\n    return `${header}\\n${truncateText(item.text, MAX_OBSERVATION_ITEM_CHARS)}`;\n  }\n\n  if (item.kind === \"rgb\" || item.kind === \"depth\") {\n    return `${header}\\n${formatImageObservation(item)}`;\n  }\n\n  if (!(\"data\" in item)) {\n    return `${header}\\nNo structured payload was provided.`;\n  }\n\n  return `${header}\\n${truncateText(\n    stringifyObservationData(item.data),\n    MAX_OBSERVATION_ITEM_CHARS,\n  )}`;\n}\n\nfunction formatObservationOutput(observation: PhysicalObservation): string {\n  const summary =\n    observation.summary ??\n    `${observation.items.length} observation item(s) captured.`;\n  if (observation.items.length === 0) {\n    return summary;\n  }\n\n  const sections = [\n    summary,\n    ...observation.items.map((item, index) =>\n      formatObservationItem(item, index),\n    ),\n  ];\n  const output = sections.join(\"\\n\\n\");\n  return truncateText(output, MAX_OBSERVATION_OUTPUT_CHARS);\n}\n\nfunction parseImageData(\n  item: PhysicalObservationItem,\n): { data: string; mediaType: string } | undefined {\n  if (item.kind !== \"rgb\" && item.kind !== \"depth\") {\n    return undefined;\n  }\n\n  if (!item.dataUrl) {\n    return undefined;\n  }\n\n  const match = item.dataUrl.match(/^data:([^;,]+)(?:;[^,]*)?,(.*)$/s);\n  if (!match) {\n    return undefined;\n  }\n\n  return {\n    mediaType: item.mimeType ?? match[1] ?? \"image/png\",\n    data: match[2] ?? \"\",\n  };\n}\n\nfunction createObservationModelOutput(\n  observation: PhysicalObservation,\n  output: string,\n): ToolModelOutput {\n  const parts: ToolModelContentPart[] = [{ type: \"text\", text: output }];\n\n  for (const item of observation.items) {\n    const image = parseImageData(item);\n    if (!image) {\n      continue;\n    }\n    parts.push({\n      type: \"file-data\",\n      data: image.data,\n      mediaType: image.mediaType,\n    });\n  }\n\n  return parts.length > 1\n    ? {\n        type: \"content\",\n        value: parts,\n      }\n    : {\n        type: \"text\",\n        value: output,\n      };\n}\n\nexport function createPhysicalStatusTool(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  return Tool.define(\n    toolName(\"status\", options),\n    {\n      description:\n        \"Read the current physical session state and lifecycle status without moving or changing the environment.\",\n      parameters: z.object({}),\n      capabilities: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n      execute: async () => {\n        const state = await session.getState();\n        return {\n          title: \"Physical Session Status\",\n          output: describePhysicalState(state),\n          metadata: {\n            physical: {\n              sessionId: session.id,\n              status: state.status,\n              state,\n            },\n          } as PhysicalToolMetadata,\n        };\n      },\n    },\n    {\n      capabilitiesHint: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n    },\n  );\n}\n\nexport function createPhysicalObserveTool(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  return Tool.define(\n    toolName(\"observe\", options),\n    {\n      description:\n        \"Capture the latest physical-world observation and session context for the active robot or simulator without moving or changing the environment.\",\n      parameters: z.object({\n        includeImages: z\n          .boolean()\n          .optional()\n          .describe(\n            \"Whether image observations should be included when available.\",\n          ),\n        includeArtifacts: z\n          .boolean()\n          .optional()\n          .describe(\n            \"Whether artifact references should be included when available.\",\n          ),\n        maxItems: z\n          .number()\n          .int()\n          .positive()\n          .optional()\n          .describe(\"Maximum number of observation items to return.\"),\n      }),\n      capabilities: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n      execute: async (params) => {\n        if (!session.observe) {\n          return {\n            title: \"Observation Unsupported\",\n            output: \"This physical session does not expose observations.\",\n            metadata: {\n              physical: {\n                sessionId: session.id,\n              },\n            } as PhysicalToolMetadata,\n          };\n        }\n\n        const observeOptions: PhysicalObserveOptions = {\n          includeImages: params.includeImages,\n          includeArtifacts: params.includeArtifacts,\n          maxItems: params.maxItems,\n        };\n        const observation = await session.observe(observeOptions);\n        const output = formatObservationOutput(observation);\n        return {\n          title: \"Physical Observation\",\n          output,\n          metadata: {\n            modelOutput: createObservationModelOutput(observation, output),\n            physical: {\n              sessionId: session.id,\n              status: observation.status,\n              observation,\n            },\n          } as PhysicalToolMetadata,\n        };\n      },\n    },\n    {\n      capabilitiesHint: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n    },\n  );\n}\n\nexport function createPhysicalRunCodeTool(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  return Tool.define(\n    toolName(\"run_policy_code\", options),\n    {\n      description:\n        \"Execute policy code inside the active physical session after observing the current context. This can move a robot or mutate a simulator.\",\n      parameters: z.object({\n        code: z.string().min(1).describe(\"Executable policy code.\"),\n        language: z\n          .string()\n          .optional()\n          .describe(\"Code language. Defaults to the session runtime language.\"),\n        timeoutMs: z\n          .number()\n          .int()\n          .positive()\n          .optional()\n          .describe(\"Optional execution timeout in milliseconds.\"),\n        dryRun: z\n          .boolean()\n          .optional()\n          .describe(\n            \"Validate or stage the code without executing if supported.\",\n          ),\n      }),\n      capabilities: {\n        parallelSafe: false,\n        readOnly: false,\n        destructive: true,\n        riskLevel: \"dangerous\",\n        onInterrupt: \"cancel\",\n      },\n      replayPolicy: {\n        mode: \"manual\",\n        sideEffectLevel: \"external\",\n        reason:\n          \"Physical code execution may move hardware or mutate simulator state and must not be replayed automatically.\",\n      },\n      execute: async (params) => {\n        if (!session.executeCode) {\n          return {\n            title: \"Policy Execution Unsupported\",\n            output:\n              \"This physical session does not expose direct policy-code execution.\",\n            metadata: {\n              physical: {\n                sessionId: session.id,\n              },\n            } as PhysicalToolMetadata,\n          };\n        }\n\n        const policy = normalizePhysicalSafetyPolicy({\n          riskLevel: \"dangerous\",\n          requiresApproval: true,\n          requiresHumanPresence: true,\n        });\n        const trace = await session.executeCode({\n          code: params.code,\n          language: params.language,\n          timeoutMs: params.timeoutMs,\n          dryRun: params.dryRun,\n          metadata: { safety: policy },\n        });\n\n        return {\n          title: \"Physical Policy Execution\",\n          output: formatExecutionOutput(trace),\n          metadata: {\n            physical: {\n              sessionId: session.id,\n              trace,\n            },\n          } as PhysicalToolMetadata,\n        };\n      },\n    },\n    {\n      capabilitiesHint: {\n        parallelSafe: false,\n        readOnly: false,\n        destructive: true,\n        riskLevel: \"dangerous\",\n        onInterrupt: \"cancel\",\n      },\n    },\n  );\n}\n\nexport function createPhysicalStopTool(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  return Tool.define(\n    toolName(\"stop\", options),\n    {\n      description:\n        \"Stop the active physical session as quickly as the backend supports. Use only when requested or when continuing would be unsafe.\",\n      parameters: z.object({\n        reason: z\n          .string()\n          .optional()\n          .describe(\"Reason for stopping the session.\"),\n      }),\n      capabilities: {\n        parallelSafe: false,\n        readOnly: false,\n        destructive: true,\n        riskLevel: \"dangerous\",\n        onInterrupt: \"cancel\",\n      },\n      replayPolicy: {\n        mode: \"manual\",\n        sideEffectLevel: \"external\",\n        reason:\n          \"Stopping a physical session is a control-plane side effect and should not be replayed automatically.\",\n      },\n      execute: async ({ reason }) => {\n        const state = await session.stop(reason);\n        return {\n          title: \"Physical Session Stopped\",\n          output: describePhysicalState(state),\n          metadata: {\n            physical: {\n              sessionId: session.id,\n              status: state.status,\n              state,\n            },\n          } as PhysicalToolMetadata,\n        };\n      },\n    },\n    {\n      capabilitiesHint: {\n        parallelSafe: false,\n        readOnly: false,\n        destructive: true,\n        riskLevel: \"dangerous\",\n        onInterrupt: \"cancel\",\n      },\n    },\n  );\n}\n\nexport function createPhysicalArtifactsTool(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  return Tool.define(\n    toolName(\"artifacts\", options),\n    {\n      description:\n        \"List artifacts produced by the active physical session, such as logs, generated code, images, videos, or result directories.\",\n      parameters: z.object({\n        kind: z\n          .enum([\"code\", \"log\", \"image\", \"video\", \"json\", \"directory\", \"other\"])\n          .optional()\n          .describe(\"Optional artifact kind filter.\"),\n        limit: z\n          .number()\n          .int()\n          .positive()\n          .optional()\n          .describe(\"Maximum number of artifacts to return.\"),\n      }),\n      capabilities: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n      execute: async (params) => {\n        if (!session.listArtifacts) {\n          return {\n            title: \"Artifacts Unsupported\",\n            output: \"This physical session does not expose artifacts.\",\n            metadata: {\n              physical: {\n                sessionId: session.id,\n              },\n            } as PhysicalToolMetadata,\n          };\n        }\n\n        const listOptions: PhysicalListArtifactsOptions = {\n          kind: params.kind,\n          limit: params.limit,\n        };\n        const artifacts = await session.listArtifacts(listOptions);\n        const output =\n          artifacts.length === 0\n            ? \"No physical-session artifacts found.\"\n            : artifacts\n                .map((artifact) => `${artifact.kind}: ${artifact.uri}`)\n                .join(\"\\n\");\n        return {\n          title: \"Physical Artifacts\",\n          output,\n          metadata: {\n            physical: {\n              sessionId: session.id,\n              artifacts,\n            },\n          } as PhysicalToolMetadata,\n        };\n      },\n    },\n    {\n      capabilitiesHint: {\n        parallelSafe: true,\n        readOnly: true,\n        riskLevel: \"safe\",\n      },\n    },\n  );\n}\n\nexport function createPhysicalSessionTools(\n  session: PhysicalSession,\n  options?: PhysicalToolOptions,\n) {\n  const tools: Tool.AnyInfo[] = [\n    createPhysicalStatusTool(session, options),\n    createPhysicalObserveTool(session, options),\n    createPhysicalArtifactsTool(session, options),\n    createPhysicalStopTool(session, options),\n  ];\n\n  if (session.executeCode) {\n    tools.splice(2, 0, createPhysicalRunCodeTool(session, options));\n  }\n\n  return tools;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { PhysicalAdapter, PhysicalArtifact, PhysicalCapability, PhysicalExecutionMode, PhysicalExecutionRequest, PhysicalExecutionTrace, PhysicalFrame, PhysicalImageObservation, PhysicalListArtifactsOptions, PhysicalObservation, PhysicalObservationItem, PhysicalObservationKind, PhysicalObserveOptions, PhysicalOutcome, PhysicalPose, PhysicalQuaternionWxyz, PhysicalRiskLevel, PhysicalSafetyPolicy, PhysicalSession, PhysicalSessionStartOptions, PhysicalSessionState, PhysicalSessionStatus, PhysicalStructuredObservation, PhysicalTaskSpec, PhysicalTextObservation, PhysicalToolMetadata, PhysicalVector3, defaultPhysicalSafetyPolicy, describePhysicalState, isModeAllowed, normalizePhysicalSafetyPolicy } from '@cuylabs/physical-core';
+export { PhysicalTool, PhysicalToolOptions, createPhysicalArtifactsTool, createPhysicalObserveTool, createPhysicalRunCodeTool, createPhysicalSessionTools, createPhysicalStatusTool, createPhysicalStopTool } from './tools/index.js';
+import '@cuylabs/agent-core/tool';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,29 @@
+import {
+  createPhysicalArtifactsTool,
+  createPhysicalObserveTool,
+  createPhysicalRunCodeTool,
+  createPhysicalSessionTools,
+  createPhysicalStatusTool,
+  createPhysicalStopTool
+} from "./chunk-6VUPCNET.js";
+
+// src/index.ts
+import {
+  defaultPhysicalSafetyPolicy,
+  describePhysicalState,
+  isModeAllowed,
+  normalizePhysicalSafetyPolicy
+} from "@cuylabs/physical-core";
+export {
+  createPhysicalArtifactsTool,
+  createPhysicalObserveTool,
+  createPhysicalRunCodeTool,
+  createPhysicalSessionTools,
+  createPhysicalStatusTool,
+  createPhysicalStopTool,
+  defaultPhysicalSafetyPolicy,
+  describePhysicalState,
+  isModeAllowed,
+  normalizePhysicalSafetyPolicy
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  PhysicalAdapter,\n  PhysicalArtifact,\n  PhysicalCapability,\n  PhysicalExecutionMode,\n  PhysicalExecutionRequest,\n  PhysicalExecutionTrace,\n  PhysicalFrame,\n  PhysicalImageObservation,\n  PhysicalListArtifactsOptions,\n  PhysicalObservation,\n  PhysicalObservationItem,\n  PhysicalObservationKind,\n  PhysicalObserveOptions,\n  PhysicalOutcome,\n  PhysicalPose,\n  PhysicalQuaternionWxyz,\n  PhysicalSafetyPolicy,\n  PhysicalSession,\n  PhysicalSessionStartOptions,\n  PhysicalSessionState,\n  PhysicalSessionStatus,\n  PhysicalStructuredObservation,\n  PhysicalTaskSpec,\n  PhysicalTextObservation,\n  PhysicalToolMetadata,\n  PhysicalVector3,\n  PhysicalRiskLevel,\n} from \"@cuylabs/physical-core\";\n\nexport {\n  defaultPhysicalSafetyPolicy,\n  describePhysicalState,\n  isModeAllowed,\n  normalizePhysicalSafetyPolicy,\n} from \"@cuylabs/physical-core\";\n\nexport {\n  createPhysicalArtifactsTool,\n  createPhysicalObserveTool,\n  createPhysicalRunCodeTool,\n  createPhysicalSessionTools,\n  createPhysicalStatusTool,\n  createPhysicalStopTool,\n  type PhysicalToolOptions,\n} from \"./tools/index.js\";\n\nexport type { PhysicalTool } from \"./tools/index.js\";\n"],"mappings":";;;;;;;;;;AA8BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/tools/index.d.ts

@@ -0,0 +1,41 @@
+import { PhysicalSession, PhysicalToolMetadata } from '@cuylabs/physical-core';
+import { Tool } from '@cuylabs/agent-core/tool';
+import { z } from 'zod';
+
+type PhysicalTool = Tool.Info;
+interface PhysicalToolOptions {
+    /**
+     * Prefix used for generated tool ids. Defaults to "physical".
+     */
+    prefix?: string;
+}
+declare function createPhysicalStatusTool(session: PhysicalSession, options?: PhysicalToolOptions): Tool.Info<z.ZodObject<{}, z.core.$strip>, PhysicalToolMetadata>;
+declare function createPhysicalObserveTool(session: PhysicalSession, options?: PhysicalToolOptions): Tool.Info<z.ZodObject<{
+    includeImages: z.ZodOptional<z.ZodBoolean>;
+    includeArtifacts: z.ZodOptional<z.ZodBoolean>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, PhysicalToolMetadata>;
+declare function createPhysicalRunCodeTool(session: PhysicalSession, options?: PhysicalToolOptions): Tool.Info<z.ZodObject<{
+    code: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, PhysicalToolMetadata>;
+declare function createPhysicalStopTool(session: PhysicalSession, options?: PhysicalToolOptions): Tool.Info<z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, PhysicalToolMetadata>;
+declare function createPhysicalArtifactsTool(session: PhysicalSession, options?: PhysicalToolOptions): Tool.Info<z.ZodObject<{
+    kind: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        code: "code";
+        log: "log";
+        image: "image";
+        video: "video";
+        directory: "directory";
+        other: "other";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, PhysicalToolMetadata>;
+declare function createPhysicalSessionTools(session: PhysicalSession, options?: PhysicalToolOptions): Tool.AnyInfo[];
+
+export { type PhysicalTool, type PhysicalToolOptions, createPhysicalArtifactsTool, createPhysicalObserveTool, createPhysicalRunCodeTool, createPhysicalSessionTools, createPhysicalStatusTool, createPhysicalStopTool };

package/dist/tools/index.js

@@ -0,0 +1,17 @@
+import {
+  createPhysicalArtifactsTool,
+  createPhysicalObserveTool,
+  createPhysicalRunCodeTool,
+  createPhysicalSessionTools,
+  createPhysicalStatusTool,
+  createPhysicalStopTool
+} from "../chunk-6VUPCNET.js";
+export {
+  createPhysicalArtifactsTool,
+  createPhysicalObserveTool,
+  createPhysicalRunCodeTool,
+  createPhysicalSessionTools,
+  createPhysicalStatusTool,
+  createPhysicalStopTool
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/docs/README.md

@@ -0,0 +1,38 @@
+# @cuylabs/physical-agent-core Docs
+
+`@cuylabs/physical-agent-core` binds `@cuylabs/physical-core` sessions to
+`@cuylabs/agent-core` tools.
+
+Use it for generic model-facing tools over a `PhysicalSession`. Keep backend
+runtime clients in backend packages such as `@cuylabs/physical-capx`.
+
+## Tool Mapping
+
+```text
+physical_status          -> session.getState()
+physical_observe         -> session.observe()
+physical_artifacts       -> session.listArtifacts()
+physical_stop            -> session.stop()
+physical_run_policy_code -> session.executeCode()
+```
+
+`physical_run_policy_code` is only created when the session implements
+`executeCode`. That keeps observe-only and externally controlled sessions from
+exposing a mutating tool they cannot safely execute.
+
+## Model Output
+
+Observation tools return readable text output for transcripts and structured
+metadata for host applications. Image observations with `dataUrl` values are
+also mapped into `agent-core` model-output metadata so image-capable models can
+inspect rendered frames on the next reasoning step.
+
+## Safety And Dispatch
+
+This package annotates physical tools with conservative capability metadata.
+Host applications should still apply their own approval and scheduling policy,
+especially for hardware sessions and policy-code execution.
+
+`@cuylabs/physical-agent-core` does not enforce hardware safety by itself. It
+provides the generic tool surface and metadata that `agent-core` applications
+can use for approval prompts, audit logs, and dispatch control.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@cuylabs/physical-agent-core",
+  "version": "0.1.1",
+  "description": "Agent-core tools for physical AI sessions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "default": "./dist/tools/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "dependencies": {
+    "zod": "^3.25.76 || ^4.1.8",
+    "@cuylabs/physical-core": "^0.1.1"
+  },
+  "devDependencies": {
+    "@cuylabs/agent-core": "^7.2.1",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@cuylabs/agent-core": "^7.0.0"
+  },
+  "keywords": [
+    "agent",
+    "physical-ai",
+    "robotics",
+    "tools",
+    "safety"
+  ],
+  "author": "cuylabs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cuylabs-ai/physical-ai-ts.git",
+    "directory": "packages/physical-agent-core"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}