npm - open-research-protocol - Versions diffs - 0.4.13 → 0.4.15 - Mend

open-research-protocol 0.4.13 → 0.4.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

package/AGENT_INTEGRATION.md +50 -0
package/README.md +273 -144
package/bin/orp.js +14 -1
package/cli/orp.py +14846 -9925
package/docs/AGENT_LOOP.md +13 -0
package/docs/AGENT_MODES.md +79 -0
package/docs/CANONICAL_CLI_BOUNDARY.md +15 -0
package/docs/EXCHANGE.md +94 -0
package/docs/LAUNCH_KIT.md +107 -0
package/docs/ORP_HOSTED_WORKSPACE_CONTRACT.md +295 -0
package/docs/ORP_PUBLIC_LAUNCH_CHECKLIST.md +5 -0
package/docs/START_HERE.md +567 -0
package/package.json +5 -2
package/packages/lifeops-orp/README.md +67 -0
package/packages/lifeops-orp/package.json +48 -0
package/packages/lifeops-orp/src/index.d.ts +106 -0
package/packages/lifeops-orp/src/index.js +7 -0
package/packages/lifeops-orp/src/mapping.js +309 -0
package/packages/lifeops-orp/src/workspace.js +108 -0
package/packages/lifeops-orp/test/orp.test.js +187 -0
package/packages/orp-workspace-launcher/README.md +82 -0
package/packages/orp-workspace-launcher/package.json +39 -0
package/packages/orp-workspace-launcher/src/commands.js +77 -0
package/packages/orp-workspace-launcher/src/core-plan.js +506 -0
package/packages/orp-workspace-launcher/src/hosted-state.js +208 -0
package/packages/orp-workspace-launcher/src/index.js +82 -0
package/packages/orp-workspace-launcher/src/ledger.js +745 -0
package/packages/orp-workspace-launcher/src/list.js +488 -0
package/packages/orp-workspace-launcher/src/orp-command.js +126 -0
package/packages/orp-workspace-launcher/src/orp.js +912 -0
package/packages/orp-workspace-launcher/src/registry.js +558 -0
package/packages/orp-workspace-launcher/src/slot.js +188 -0
package/packages/orp-workspace-launcher/src/sync.js +363 -0
package/packages/orp-workspace-launcher/src/tabs.js +166 -0
package/packages/orp-workspace-launcher/test/commands.test.js +164 -0
package/packages/orp-workspace-launcher/test/core-plan.test.js +253 -0
package/packages/orp-workspace-launcher/test/fixtures/smoke-notes.txt +2 -0
package/packages/orp-workspace-launcher/test/fixtures/workspace-manifest.json +17 -0
package/packages/orp-workspace-launcher/test/ledger.test.js +244 -0
package/packages/orp-workspace-launcher/test/list.test.js +299 -0
package/packages/orp-workspace-launcher/test/orp-command.test.js +44 -0
package/packages/orp-workspace-launcher/test/orp.test.js +224 -0
package/packages/orp-workspace-launcher/test/tabs.test.js +168 -0
package/scripts/orp-kernel-agent-pilot.py +10 -1
package/scripts/orp-kernel-agent-replication.py +10 -1
package/scripts/orp-kernel-canonical-continuation.py +10 -1
package/scripts/orp-kernel-continuation-pilot.py +10 -1
package/scripts/render-terminal-demo.py +416 -0
package/spec/v1/exchange-report.schema.json +105 -0
package/spec/v1/hosted-workspace-event.schema.json +102 -0
package/spec/v1/hosted-workspace.schema.json +332 -0
package/spec/v1/workspace.schema.json +108 -0

package/spec/v1/hosted-workspace.schema.json ADDED Viewed

@@ -0,0 +1,332 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openresearchprotocol.com/spec/v1/hosted-workspace.schema.json",
+  "title": "ORP Hosted Workspace",
+  "description": "Canonical hosted source-of-truth record for an ORP workspace that can be reopened locally and inspected on ORP.Earth.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "workspace_id",
+    "title",
+    "source_of_truth",
+    "state",
+    "created_at_utc",
+    "updated_at_utc"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "1.0.0"
+    },
+    "workspace_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "slug": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "visibility": {
+      "type": "string",
+      "enum": [
+        "private",
+        "team",
+        "public"
+      ]
+    },
+    "source_of_truth": {
+      "type": "string",
+      "const": "hosted-workspace"
+    },
+    "linked_idea": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "idea_id"
+      ],
+      "properties": {
+        "idea_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "idea_title": {
+          "type": "string"
+        },
+        "relationship": {
+          "type": "string",
+          "enum": [
+            "primary",
+            "mirror",
+            "reference"
+          ]
+        }
+      }
+    },
+    "bridge": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "legacy_idea_notes_enabled": {
+          "type": "boolean"
+        },
+        "legacy_idea_id": {
+          "type": "string"
+        },
+        "legacy_manifest_synced_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "state": {
+      "$ref": "#/$defs/current_state"
+    },
+    "latest_event": {
+      "$ref": "#/$defs/event_preview"
+    },
+    "metrics": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tab_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "project_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "codex_session_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "tmux_session_count": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "created_at_utc": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated_at_utc": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "last_opened_at_utc": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "last_captured_at_utc": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "$defs": {
+    "current_state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state_version",
+        "snapshot_id",
+        "updated_at_utc",
+        "tab_count",
+        "tabs"
+      ],
+      "properties": {
+        "state_version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "snapshot_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "summary": {
+          "type": "string"
+        },
+        "current_focus": {
+          "type": "string"
+        },
+        "trajectory": {
+          "type": "string"
+        },
+        "opened_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "captured_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updated_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "tab_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "capture_context": {
+          "$ref": "#/$defs/capture_context"
+        },
+        "tabs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/tab"
+          }
+        }
+      }
+    },
+    "capture_context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "source_app": {
+          "type": "string"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "snapshot",
+            "watch",
+            "sync",
+            "manual"
+          ]
+        },
+        "host": {
+          "type": "string"
+        },
+        "window_id": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "window_index": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "poll_seconds": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "terminal_frontend": {
+          "type": "string",
+          "enum": [
+            "iterm",
+            "terminal",
+            "unknown"
+          ]
+        },
+        "durable_backend": {
+          "type": "string",
+          "enum": [
+            "tmux",
+            "direct",
+            "unknown"
+          ]
+        }
+      }
+    },
+    "tab": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "tab_id",
+        "order_index",
+        "project_root",
+        "status"
+      ],
+      "properties": {
+        "tab_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "order_index": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "title": {
+          "type": "string"
+        },
+        "project_root": {
+          "type": "string",
+          "pattern": "^/"
+        },
+        "repo_label": {
+          "type": "string"
+        },
+        "codex_session_id": {
+          "type": "string"
+        },
+        "tmux_session_name": {
+          "type": "string"
+        },
+        "terminal_title": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "active",
+            "removed",
+            "archived"
+          ]
+        },
+        "current_task": {
+          "type": "string"
+        },
+        "focus_summary": {
+          "type": "string"
+        },
+        "trajectory_summary": {
+          "type": "string"
+        },
+        "last_activity_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "linked_idea_id": {
+          "type": "string"
+        },
+        "linked_feature_id": {
+          "type": "string"
+        }
+      }
+    },
+    "event_preview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "event_id",
+        "event_type",
+        "created_at_utc"
+      ],
+      "properties": {
+        "event_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "event_type": {
+          "type": "string",
+          "minLength": 1
+        },
+        "summary": {
+          "type": "string"
+        },
+        "created_at_utc": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}

package/spec/v1/workspace.schema.json ADDED Viewed

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://orp.dev/spec/v1/workspace.schema.json",
+  "title": "ORP Workspace Manifest",
+  "description": "Structured workspace launcher manifest for ORP iTerm/tmux workspace restoration.",
+  "type": "object",
+  "required": ["version", "tabs"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1"
+    },
+    "workspaceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tmuxPrefix": {
+      "type": "string",
+      "minLength": 1
+    },
+    "capture": {
+      "type": "object",
+      "properties": {
+        "sourceApp": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["snapshot", "watch"]
+        },
+        "host": {
+          "type": "string",
+          "minLength": 1
+        },
+        "windowId": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "windowIndex": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "tabCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "capturedAt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "trackingStartedAt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "pollSeconds": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "tabs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["path"],
+        "properties": {
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^/"
+          },
+          "resumeCommand": {
+            "type": "string",
+            "minLength": 1
+          },
+          "resumeTool": {
+            "type": "string",
+            "enum": ["codex", "claude"]
+          },
+          "resumeSessionId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "codexSessionId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tmuxSessionName": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}