@webx-ui/module-tasks 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 webx-ui
+
+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/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @webx-ui/module-tasks
 
-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.
+The «Tasks» section of the [WebX UI](https://github.com/webx-ui/webx-ui) admin panel: a queue of
+work between people and AI agents. The list of tasks with its views («Waiting for me», «In work»,
+drafts, closed), one task with its specification, its stages and their reports, the buttons a
+reviewer and a planner press (accept, send back, answer a question, release, cancel) and the
+journal; the form of a task — the described screen `tasks.form` — and the projects.
+
+The server half is the Composer package `webx-ui/module-tasks`; agents work the queue over its MCP
+tools.
+
+```ts
+import { createAdmin } from '@webx-ui/module-admin'
+import { tasks } from '@webx-ui/module-tasks'
+import '@webx-ui/module-tasks/style.css'
+
+createAdmin({ modules: [tasks()] })
+```
+
+Beside the menu entry the panel shows how many tasks wait for a person — a stage to review, or an
+agent's question — when the signed-in administrator can act on them.
+
+MIT.

package/dist/ProjectDialog.d.ts

@@ -0,0 +1,8 @@
+import { Project } from './types';
+type __VLS_Props = {
+    project?: Project | null;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    project: Project | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ProjectsPage.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    base?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    base: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/TaskFormPage.d.ts

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    id?: number | null;
+    base?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    id: number | null;
+    base: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/TaskPage.d.ts

@@ -0,0 +1,8 @@
+type __VLS_Props = {
+    id: number;
+    base?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    base: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/TasksMarkdown.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    source: string | null | undefined;
+    empty?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/TasksPage.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    base?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    base: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/TasksSettingsPage.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    base?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    base: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/TasksTextDialog.d.ts

@@ -0,0 +1,17 @@
+type __VLS_Props = {
+    title: string;
+    label: string;
+    confirmText: string;
+    cancelText: string;
+    message?: string;
+    required?: boolean;
+    danger?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    required: boolean;
+    danger: boolean;
+    message: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    form: HTMLFormElement;
+}, any>;
+export default _default;

package/dist/api.d.ts

@@ -0,0 +1,29 @@
+import { AdminContext } from '@webx-ui/module-admin';
+import { NotificationSettings, Project, ProjectInput, TaskDetail, TaskInput, TaskQuery, TasksPage } from './types';
+export interface TasksApi {
+    projects(): Promise<Project[]>;
+    createProject(input: ProjectInput): Promise<Project>;
+    saveProject(id: number, input: ProjectInput): Promise<Project>;
+    /** A page of tasks under a view, with the count of every view. */
+    tasks(query?: TaskQuery): Promise<TasksPage>;
+    task(id: number): Promise<TaskDetail>;
+    /** A draft with its stages. */
+    create(input: TaskInput): Promise<TaskDetail>;
+    /** Within the rules of §3: refused with 409 and the reason when the task has started. */
+    save(id: number, input: TaskInput): Promise<TaskDetail>;
+    ready(id: number): Promise<TaskDetail>;
+    cancel(id: number, reason?: string): Promise<TaskDetail>;
+    comment(id: number, body: string, stageId?: number | null): Promise<TaskDetail>;
+    accept(stage: number, note?: string): Promise<TaskDetail>;
+    rework(stage: number, remarks: string): Promise<TaskDetail>;
+    unblock(stage: number, answer: string): Promise<TaskDetail>;
+    release(stage: number, reason?: string): Promise<TaskDetail>;
+    cancelStage(stage: number, reason?: string): Promise<TaskDetail>;
+    /** The notification settings; the bot token only as whether one is set. */
+    settings(): Promise<NotificationSettings>;
+    saveSettings(values: Record<string, unknown>, forgetToken?: boolean): Promise<NotificationSettings>;
+    /** Sends one message now; refused with 409 and Telegram's own words when it does not get through. */
+    testNotice(): Promise<string>;
+}
+/** The queue's endpoints under the panel's API path; every change answers the whole task. */
+export declare function createTasksApi(admin: AdminContext): TasksApi;

package/dist/i18n.d.ts

@@ -0,0 +1,2 @@
+/** Puts this package's English under the panel's dictionary, once per panel. */
+export declare function useTasksMessages(): void;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { tasks, type TasksOptions } from './module';
+export { createTasksApi, type TasksApi } from './api';
+export { tasksMessages } from './messages';
+export { default as WxTasksPage } from './TasksPage';
+export { default as WxTaskPage } from './TaskPage';
+export { default as WxTaskFormPage } from './TaskFormPage';
+export { default as WxTasksProjectsPage } from './ProjectsPage';
+export { default as WxTasksSettingsPage } from './TasksSettingsPage';
+export type { CurrentStage, JournalEntry, JournalKind, NotificationSettings, Priority, Project, ProjectInput, ReviewMode, Stage, StageInput, StageStatus, TaskDetail, TaskInput, TaskQuery, TaskRow, TasksPage, TaskStatus, TaskView, } from './types';