@agimon-ai/po-loop 0.0.0-alpha.1 → 0.0.0-stage

package/README.md

@@ -1,101 +1,3 @@
-# @agimon-ai/po-loop
+# Temporary Holding Version
 
-Send a prompt now, then repeat it at a bounded interval for the current session.
-
-Part of the [Po distribution](https://www.npmjs.com/package/@agimon-ai/po).
-
-Several loops can coexist. Loop is a minor mode and remains active while at least one scheduled
-prompt belongs to the current session.
-
-> **Alpha:** launcher and scheduling contracts may change between releases.
-
-## Requirements
-
-- Node.js 24 or newer
-
-## Install
-
-The seeded `modes.yaml` selects Loop in `default.packages`. Keep it there or select it through a
-layer; it is not fixed host infrastructure.
-
-## Start and manage loops
-
-Activate the Loop minor mode, then ask the agent to set an interval loop or a cron job; it uses the
-`loop_start` tool. The Activity Loops section lists the session's loops whether or not the mode is
-active, and each row has a stop control. `/loops` lists loops and `/loops stop <instanceId>` stops
-one.
-
-The default interval is 300 seconds. Accepted intervals range from 30 to 3600 seconds. A loop runs
-its prompt once immediately, then schedules later passes.
-
-If Pi is busy, a due pass waits for the shared agent to become idle. Multiple due signals can
-coalesce rather than creating overlapping model turns. Stopping a loop prevents future passes but
-does not rewind side effects from a pass already sent.
-
-## Lifecycle and cost
-
-Loop state belongs to the session's `doom/loop-launchers` service; it is not a durable queue.
-Replacing or shutting down the session aborts pending launches and stops active timers. Resuming a
-transcript does not restart old loops.
-
-Every pass can start another model turn and repeat tool or external side effects. Choose
-conservative intervals, make prompts idempotent where possible, and stop loops when the recurring
-work is complete.
-
-## Web extension slots
-
-The Loop Activity section declares `loop.registration` for start controls and `loop.items` for
-session-scoped instance rows. Other web plugins may fill either slot; Loop owns the section shell and
-renders all registered fills without requiring a feature-specific dependency.
-
-## Extension authors: cross-extension launchers
-
-Launcher definitions use the shared Cordis service. A consumer registers a launcher and returns its
-cleanup callback. Cordis removes that launcher when either package or the session unloads, then
-registers it again when the provider returns.
-
-```ts
-import { DOOM_LOOP_LAUNCHERS_SERVICE, requireDoomLoopLaunchers } from '@agimon-ai/po-loop/loop-launchers';
-import type { Context } from '@deepseek-ai/cordis';
-
-export function myLoopPlugin(ctx: Context): void {
-  ctx.inject([DOOM_LOOP_LAUNCHERS_SERVICE], (sessionContext) => {
-    const registration = requireDoomLoopLaunchers(sessionContext).register({
-      id: 'example.recurring-check',
-      source: '@example/po-recurring-check',
-      label: 'Recurring check',
-      async launch({ instanceId, signal }) {
-        signal.throwIfAborted();
-        // Start session work. The returned stop callback owns cleanup.
-        return { instanceId, stop: () => undefined };
-      },
-    });
-    return () => registration.dispose('Contributor unloaded.');
-  });
-}
-```
-
-Mount that plugin on the runner's shared Doom Cordis root. Loop owns the registry and default
-launcher. Consumers depend only on
-`@agimon-ai/po-loop/loop-launchers`; there is no process-global registry or
-session-ID lookup API.
-
-The package root exports the service contract
-types.
-
-## Development
-
-```bash
-pnpm build
-pnpm typecheck
-pnpm test
-pnpm lint
-```
-
-Maintained by [Agimon](https://agimon.ai/about).
-
-## License
-
-MIT
-
-Server entries live directly in `src/extensions/`. They declare commands, minor mode owners, and optional services. The helpers own registration and cleanup; `onDispose` clears UI state, while session service disposal stops pending launches and timers. Services live in named folders and public exports remain flat.
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,125 +1,6 @@
 {
   "name": "@agimon-ai/po-loop",
-  "version": "0.0.0-alpha.1",
-  "description": "Session-scoped recurring prompt scheduler and loop controls for Pi coding agents.",
-  "keywords": [
-    "ai",
-    "automation",
-    "coding-agent",
-    "developer-tools",
-    "pi-coding-agent",
-    "pi-extension",
-    "pi-package",
-    "po",
-    "prompt-scheduler",
-    "recurring-tasks"
-  ],
-  "homepage": "https://agimon.ai",
-  "bugs": {
-    "url": "https://github.com/AgiFlow/po/issues"
-  },
-  "license": "MIT",
-  "author": "Vuong Ngo",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AgiFlow/po.git",
-    "directory": "packages/minor/po-loop"
-  },
-  "files": [
-    "dist",
-    "llms.txt",
-    "src/prompts",
-    "src/types/loopView.ts",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ],
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "jsnext:main": "./dist/index.mjs",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    },
-    "./extensions/server": {
-      "types": "./dist/extensions/server.d.mts",
-      "import": "./dist/extensions/server.mjs",
-      "require": "./dist/extensions/server.cjs"
-    },
-    "./extensions/web": {
-      "import": "./dist/extensions/web.mjs"
-    },
-    "./loopLaunchers": {
-      "types": "./dist/loopLaunchers.d.mts",
-      "import": "./dist/loopLaunchers.mjs",
-      "require": "./dist/loopLaunchers.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.1",
-    "@agimon-ai/po-minor-mode": "0.0.0-alpha.1",
-    "@agimon-ai/po-ui": "0.0.0-alpha.1",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.1",
-    "@deepseek-ai/cordis": "4.0.4",
-    "croner": "10.0.1",
-    "typebox": "1.3.34"
-  },
-  "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.1",
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@types/node": "26.6.4",
-    "@types/react": "19.3.0",
-    "@types/react-dom": "19.3.0",
-    "@vitest/coverage-v8": "5.0.3",
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
-    "tsdown": "0.23.0",
-    "typescript": "7.0.2",
-    "vitest": "5.0.3"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.0.2"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "poServer": {
-    "entry": "./generated/server.ts",
-    "dist": "./dist/extensions/server.mjs",
-    "scopes": [
-      "session"
-    ],
-    "contracts": {
-      "entry": "./src/exports/apiContracts.ts",
-      "dist": "./dist/apiContracts.mjs"
-    }
-  },
-  "poWeb": {
-    "pluginId": "loop",
-    "channels": [],
-    "client": "./dist/extensions/web.mjs",
-    "scopes": [
-      "session"
-    ]
-  },
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest --run",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
-    "lint": "oxlint . && oxfmt . --check",
-    "fixcode": "oxlint . --fix && oxfmt ."
-  }
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Vuong Ngo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/apiContracts.cjs

@@ -1,17 +0,0 @@
-Object.defineProperties(exports, {
-	__esModule: { value: true },
-	[Symbol.toStringTag]: { value: "Module" }
-});
-//#region src/schemas/apiContracts.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
-const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
-	version: 1,
-	http: [],
-	sockets: [],
-	dynamic: []
-});
-//#endregion
-exports.apiContracts = apiContracts;
-exports.default = apiContracts;
-
-//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -1,53 +0,0 @@
-//#region src/schemas/apiContracts.d.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
-export declare const apiContracts: {
-  version: 1;
-  protocols?: Record<string, string> | undefined;
-  schemas?: Record<string, boolean | object> | undefined;
-  http: {
-    id: string;
-    scope: "global" | "session" | "workspace";
-    basePath?: string | undefined;
-    path: string;
-    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
-    description: string;
-    availability?: string | undefined;
-    authentication: "device" | "none" | "owner";
-    parameters?: {
-      name: string;
-      in: "header" | "path" | "query";
-      required: boolean;
-      schema: boolean | object;
-    }[] | undefined;
-    body?: {
-      contentType: string;
-      contentTypes?: string[] | undefined;
-      required: boolean;
-      schema: boolean | object;
-    } | undefined;
-    responses: Record<string, {
-      description: string;
-      contentType?: string | undefined;
-      schema?: boolean | object | undefined;
-      events?: Record<string, boolean | object> | undefined;
-    }>;
-  }[];
-  sockets: {
-    id: string;
-    scope: "global" | "session" | "workspace";
-    description: string;
-    availability?: string | undefined;
-    service: string;
-    member: string;
-    direction: "client-to-server" | "server-to-client";
-    kind: "channel" | "method" | "state";
-    input: boolean | object;
-    output?: boolean | object | undefined;
-    errors?: boolean | object | undefined;
-  }[];
-  dynamic: string[];
-  gaps?: string[] | undefined;
-};
-//#endregion
-export { apiContracts as default };
-//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -1,13 +0,0 @@
-import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
-//#region src/schemas/apiContracts.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
-const apiContracts = defineApiContract({
-	version: 1,
-	http: [],
-	sockets: [],
-	dynamic: []
-});
-//#endregion
-export { apiContracts, apiContracts as default };
-
-//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}